<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Make Controller Kit - Firmware API: network.c Source File</title>
<link href="mt_doxygen.css" rel="stylesheet" type="text/css" />
<link href="../resources/mt_doxytabs.css" rel="stylesheet" type="text/css" />
<style type="text/css">
<!--
.header {
	font-family: Verdana, Arial, Helvetica, sans-serif;
	font-size: 12pt;
	color: #222222;
}
-->
</style>
</head>

<body>
<table width="800" border="0">
    <tr>
      <td colspan="3">
        <form method="get" action="http://www.google.com/search">
          <div align="right">
            <input type="text"   name="q" size="25"
              maxlength="255" value="" />
            <input type="submit" value="Search" />
            <input type="hidden" name="sitesearch" value="makingthings.com/ref/firmware/html" />
          </div>
        </form>
       </td>
    </tr>
    <tr>
      <td><div align="center"><a href="http://www.makingthings.com">
				<img src="../resources/logo_brown_medium.png" alt="MakingThings"
									width="200" height="78" border="0" align="middle" longdesc="http://www.makingthings.com" /></a></div></td>
				<td><div align="center" class="header">
      		Make Controller Kit <br />
          Firmware API
      </div></td>
      <td><div align="center"><a href="http://www.makezine.com">
					<img src="../resources/make_logo.png" alt="MAKE Zine" 
										width="164" height="73" border="0" align="middle" longdesc="http://www.makezine.com" /></a></div></td>
    </tr>
</table>
</body>
</html>
<!-- Generated by Doxygen 1.5.4 -->
<script type="text/javascript">
<!--
function changeDisplayState (e){
  var num=this.id.replace(/[^[0-9]/g,'');
  var button=this.firstChild;
  var sectionDiv=document.getElementById('dynsection'+num);
  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
    sectionDiv.style.display='block';
    button.src='open.gif';
  }else{
    sectionDiv.style.display='none';
    button.src='closed.gif';
  }
}
function initDynSections(){
  var divs=document.getElementsByTagName('div');
  var sectionCounter=1;
  for(var i=0;i<divs.length-1;i++){
    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
      var header=divs[i];
      var section=divs[i+1];
      var button=header.firstChild;
      if (button!='IMG'){
        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
        button=document.createElement('img');
        divs[i].insertBefore(button,divs[i].firstChild);
      }
      header.style.cursor='pointer';
      header.onclick=changeDisplayState;
      header.id='dynheader'+sectionCounter;
      button.src='closed.gif';
      section.id='dynsection'+sectionCounter;
      section.style.display='none';
      section.style.marginLeft='14px';
      sectionCounter++;
    }
  }
}
window.onload = initDynSections;
-->
</script>
<div class="tabs">
  <ul>
    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
    <li><a href="modules.html"><span>Modules</span></a></li>
    <li><a href="classes.html"><span>Data&nbsp;Structures</span></a></li>
    <li class="current"><a href="files.html"><span>Files</span></a></li>
    <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
  </ul>
</div>
<h1>network.c</h1><a href="network_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*********************************************************************************</span>
<a name="l00002"></a>00002 <span class="comment"></span>
<a name="l00003"></a>00003 <span class="comment"> Copyright 2006 MakingThings</span>
<a name="l00004"></a>00004 <span class="comment"></span>
<a name="l00005"></a>00005 <span class="comment"> Licensed under the Apache License, </span>
<a name="l00006"></a>00006 <span class="comment"> Version 2.0 (the "License"); you may not use this file except in compliance </span>
<a name="l00007"></a>00007 <span class="comment"> with the License. You may obtain a copy of the License at</span>
<a name="l00008"></a>00008 <span class="comment"></span>
<a name="l00009"></a>00009 <span class="comment"> http://www.apache.org/licenses/LICENSE-2.0 </span>
<a name="l00010"></a>00010 <span class="comment"> </span>
<a name="l00011"></a>00011 <span class="comment"> Unless required by applicable law or agreed to in writing, software distributed</span>
<a name="l00012"></a>00012 <span class="comment"> under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR</span>
<a name="l00013"></a>00013 <span class="comment"> CONDITIONS OF ANY KIND, either express or implied. See the License for</span>
<a name="l00014"></a>00014 <span class="comment"> the specific language governing permissions and limitations under the License.</span>
<a name="l00015"></a>00015 <span class="comment"></span>
<a name="l00016"></a>00016 <span class="comment">*********************************************************************************/</span>
<a name="l00017"></a>00017 <span class="comment"></span>
<a name="l00018"></a>00018 <span class="comment">/** \file network.c </span>
<a name="l00019"></a>00019 <span class="comment">  Communicate with the Make Controller Board via Ethernet.</span>
<a name="l00020"></a>00020 <span class="comment">*/</span>
<a name="l00021"></a>00021 
<a name="l00022"></a>00022 <span class="preprocessor">#include "config.h"</span>
<a name="l00023"></a>00023 <span class="preprocessor">#ifdef MAKE_CTRL_NETWORK</span>
<a name="l00024"></a>00024 <span class="preprocessor"></span>
<a name="l00025"></a>00025 <span class="preprocessor">#include "stdio.h"</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include "io.h"</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include "eeprom.h"</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include "timer.h"</span>
<a name="l00029"></a>00029 
<a name="l00030"></a>00030 <span class="comment">/* lwIP includes. */</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include "lwip/api.h"</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include "lwip/tcpip.h"</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include "lwip/memp.h"</span> 
<a name="l00034"></a>00034 <span class="preprocessor">#include "lwip/stats.h"</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include "netif/loopif.h"</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include "lwip/dhcp.h"</span>
<a name="l00037"></a>00037 
<a name="l00038"></a>00038 <span class="comment">/* Low level includes. */</span>
<a name="l00039"></a>00039 <span class="preprocessor">#include "SAM7_EMAC.h"</span>
<a name="l00040"></a>00040 
<a name="l00041"></a>00041 <span class="keywordtype">int</span> Network_AddressConvert( <span class="keywordtype">char</span>* address, <span class="keywordtype">int</span>* a0, <span class="keywordtype">int</span>* a1, <span class="keywordtype">int</span>* a2, <span class="keywordtype">int</span>* a3 );
<a name="l00042"></a>00042 
<a name="l00043"></a>00043 <span class="comment">/* MAC address definition.  The MAC address must be unique on the network. */</span>
<a name="l00044"></a>00044 <span class="keywordtype">char</span> emacETHADDR0 = 0xAC;
<a name="l00045"></a>00045 <span class="keywordtype">char</span> emacETHADDR1 = 0xDE;
<a name="l00046"></a>00046 <span class="keywordtype">char</span> emacETHADDR2 = 0x48;
<a name="l00047"></a>00047 <span class="keywordtype">char</span> emacETHADDR3 = 0x55;
<a name="l00048"></a>00048 <span class="keywordtype">char</span> emacETHADDR4 = 0x0;
<a name="l00049"></a>00049 <span class="keywordtype">char</span> emacETHADDR5 = 0x0;
<a name="l00050"></a>00050 
<a name="l00051"></a>00051 <span class="preprocessor">#include "network.h"</span>
<a name="l00052"></a>00052 <span class="preprocessor">#include "webserver.h"</span>
<a name="l00053"></a>00053 
<a name="l00054"></a>00054 <span class="keyword">typedef</span> <span class="keyword">struct </span>Network_
<a name="l00055"></a>00055 {
<a name="l00056"></a>00056   <span class="keywordtype">int</span> pending; <span class="comment">// if somebody has started the process of getting an IP address, don't start another process</span>
<a name="l00057"></a>00057   <span class="keywordtype">int</span> TempIpAddress; <span class="comment">// hold onto the values that will ultimately get set for the network</span>
<a name="l00058"></a>00058   <span class="keywordtype">int</span> TempGateway; <span class="comment">// once it's all set as valid</span>
<a name="l00059"></a>00059   <span class="keywordtype">int</span> TempMask;
<a name="l00060"></a>00060   <span class="keywordtype">int</span> OscUdpListenPort;
<a name="l00061"></a>00061   <span class="keywordtype">int</span> OscUdpSendPort;
<a name="l00062"></a>00062   <span class="keywordtype">int</span> TcpOutAddress;
<a name="l00063"></a>00063   <span class="keywordtype">int</span> TcpOutPort;
<a name="l00064"></a>00064   <span class="keywordtype">bool</span> TcpRequested;
<a name="l00065"></a>00065   <span class="keywordtype">void</span>* WebServerTaskPtr;
<a name="l00066"></a>00066 <span class="preprocessor">  #ifdef OSC</span>
<a name="l00067"></a>00067 <span class="preprocessor"></span>  <span class="keywordtype">char</span> scratch1[ OSC_SCRATCH_SIZE ];
<a name="l00068"></a>00068   <span class="keywordtype">char</span> scratch2[ OSC_SCRATCH_SIZE ];
<a name="l00069"></a>00069 <span class="preprocessor">  #endif // OSC</span>
<a name="l00070"></a>00070 <span class="preprocessor"></span>} NetworkStruct;
<a name="l00071"></a>00071 
<a name="l00072"></a>00072 <span class="comment">// a few globals</span>
<a name="l00073"></a>00073 NetworkStruct* Network;
<a name="l00074"></a>00074 
<a name="l00075"></a>00075 <span class="keyword">enum</span> { NET_UNCHECKED, NET_INVALID, NET_VALID } Network_Valid;
<a name="l00076"></a>00076 
<a name="l00077"></a>00077 <span class="keywordtype">void</span> <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( <span class="keywordtype">int</span> state );
<a name="l00078"></a>00078 <span class="keywordtype">int</span> Network_GetPending( <span class="keywordtype">void</span> );
<a name="l00079"></a>00079 <span class="keywordtype">void</span> Network_DhcpStart( <span class="keyword">struct</span> netif* netif );
<a name="l00080"></a>00080 <span class="keywordtype">void</span> Network_DhcpStop( <span class="keyword">struct</span> netif* netif );
<a name="l00081"></a>00081 <span class="keywordtype">void</span> Network_SetDefaults( <span class="keywordtype">void</span> );
<a name="l00082"></a>00082 <span class="comment"></span>
<a name="l00083"></a>00083 <span class="comment">/** \defgroup Sockets</span>
<a name="l00084"></a>00084 <span class="comment">  The Sockets system provides a simple interface for creating, reading and writing over both TCP and UDP.  </span>
<a name="l00085"></a>00085 <span class="comment">  This subsystem is a light wrapper around LwIP, the open source TCP/IP stack used by the Make Controller Kit.</span>
<a name="l00086"></a>00086 <span class="comment">  There are 3 groups of socket functions:</span>
<a name="l00087"></a>00087 <span class="comment">  - DatagramSocket - sockets for \b UDP communication</span>
<a name="l00088"></a>00088 <span class="comment">  - Socket - sockets for \b TCP communication</span>
<a name="l00089"></a>00089 <span class="comment">  - ServerSocket - sockets for accepting \b incoming TCP client connections</span>
<a name="l00090"></a>00090 <span class="comment">  \ingroup Controller</span>
<a name="l00091"></a>00091 <span class="comment">  @{</span>
<a name="l00092"></a>00092 <span class="comment">*/</span>
<a name="l00093"></a>00093 <span class="comment"></span>
<a name="l00094"></a>00094 <span class="comment">/** </span>
<a name="l00095"></a>00095 <span class="comment">  Create a new TCP socket connected to the address and port specified.</span>
<a name="l00096"></a>00096 <span class="comment">  @param address An integer specifying the IP address to connect to.</span>
<a name="l00097"></a>00097 <span class="comment">  @param port An integer specifying the port to connect on.</span>
<a name="l00098"></a>00098 <span class="comment">  @return A pointer to the socket, if it was created successfully.  NULL if unsuccessful.</span>
<a name="l00099"></a>00099 <span class="comment">  @see SocketRead(), SocketWrite(), SocketClose()</span>
<a name="l00100"></a>00100 <span class="comment"></span>
<a name="l00101"></a>00101 <span class="comment">  \par Example</span>
<a name="l00102"></a>00102 <span class="comment">  \code</span>
<a name="l00103"></a>00103 <span class="comment">  // use the IP_ADDRESS macro to format the address properly</span>
<a name="l00104"></a>00104 <span class="comment">  int addr = IP_ADDRESS( 192, 168, 0, 54 );</span>
<a name="l00105"></a>00105 <span class="comment">  // then create the socket, connecting on port 10101</span>
<a name="l00106"></a>00106 <span class="comment">  struct netconn* socket = Socket( addr, 10101 );</span>
<a name="l00107"></a>00107 <span class="comment">  \endcode</span>
<a name="l00108"></a>00108 <span class="comment">*/</span>
<a name="l00109"></a><a class="code" href="group___sockets.html#g7e4b76e6d4a93aa7c281e5cbba6cc584">00109</a> <span class="keywordtype">void</span>* <a class="code" href="group___sockets.html#g7e4b76e6d4a93aa7c281e5cbba6cc584" title="Create a new TCP socket connected to the address and port specified.">Socket</a>( <span class="keywordtype">int</span> address, <span class="keywordtype">int</span> port )
<a name="l00110"></a>00110 {
<a name="l00111"></a>00111   <a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b" title="Sets whether the Network subsystem is active.">Network_SetActive</a>( 1 );
<a name="l00112"></a>00112 
<a name="l00113"></a>00113   <span class="keyword">struct </span>netconn* conn;
<a name="l00114"></a>00114   err_t retval;
<a name="l00115"></a>00115 
<a name="l00116"></a>00116   conn = netconn_new( NETCONN_TCP );
<a name="l00117"></a>00117   <span class="comment">// This is our addition to the conn structure to help with reading</span>
<a name="l00118"></a>00118   conn-&gt;readingbuf = NULL;
<a name="l00119"></a>00119 
<a name="l00120"></a>00120   <span class="keyword">struct </span>ip_addr remote_addr;
<a name="l00121"></a>00121   remote_addr.addr = htonl(address);
<a name="l00122"></a>00122 
<a name="l00123"></a>00123   retval = netconn_connect( conn, &amp;remote_addr, port );
<a name="l00124"></a>00124   
<a name="l00125"></a>00125   <span class="keywordflow">if</span>( ERR_OK != retval )
<a name="l00126"></a>00126   {
<a name="l00127"></a>00127     <span class="comment">//netconn_delete( conn );</span>
<a name="l00128"></a>00128     <span class="keywordflow">while</span>( netconn_delete( conn ) != ERR_OK )
<a name="l00129"></a>00129       vTaskDelay( 10 );
<a name="l00130"></a>00130 
<a name="l00131"></a>00131     conn = NULL;
<a name="l00132"></a>00132   }
<a name="l00133"></a>00133   
<a name="l00134"></a>00134   <span class="keywordflow">return</span> conn;
<a name="l00135"></a>00135 }
<a name="l00136"></a>00136 <span class="comment"></span>
<a name="l00137"></a>00137 <span class="comment">/** </span>
<a name="l00138"></a>00138 <span class="comment">  Read from a TCP socket.</span>
<a name="l00139"></a>00139 <span class="comment">  Make sure you have an open socket before trying to read from it.</span>
<a name="l00140"></a>00140 <span class="comment">  @param socket A pointer to the existing socket.</span>
<a name="l00141"></a>00141 <span class="comment">  @param data A pointer to the buffer to read to.</span>
<a name="l00142"></a>00142 <span class="comment">  @param length An integer specifying the maximum length in bytes that can be read.</span>
<a name="l00143"></a>00143 <span class="comment">  @return An integer: length of data read if successful, zero on failure.</span>
<a name="l00144"></a>00144 <span class="comment">  @see Socket(), SocketClose()</span>
<a name="l00145"></a>00145 <span class="comment"></span>
<a name="l00146"></a>00146 <span class="comment">  \par Example</span>
<a name="l00147"></a>00147 <span class="comment">  \code</span>
<a name="l00148"></a>00148 <span class="comment">  // we should already have created a socket sock with Socket().</span>
<a name="l00149"></a>00149 <span class="comment">  struct netconn* sock = Socket( addr, 10101 );</span>
<a name="l00150"></a>00150 <span class="comment">  int length_read = SocketRead( sock, data, length )</span>
<a name="l00151"></a>00151 <span class="comment">  // if 0 bytes were read, there was some sort of error</span>
<a name="l00152"></a>00152 <span class="comment">  if( length_read == 0 )</span>
<a name="l00153"></a>00153 <span class="comment">    SocketClose( sock );</span>
<a name="l00154"></a>00154 <span class="comment">  \endcode</span>
<a name="l00155"></a>00155 <span class="comment">*/</span>
<a name="l00156"></a><a class="code" href="group___sockets.html#g838d1ceaf477b3496a9fe4adf8d28147">00156</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#g838d1ceaf477b3496a9fe4adf8d28147" title="Read from a TCP socket.">SocketRead</a>( <span class="keywordtype">void</span>* socket, <span class="keywordtype">char</span>* data, <span class="keywordtype">int</span> length )
<a name="l00157"></a>00157 {
<a name="l00158"></a>00158   <span class="keyword">struct </span>netconn *conn = socket;
<a name="l00159"></a>00159   <span class="keyword">struct </span>netbuf *buf;
<a name="l00160"></a>00160   <span class="keywordtype">int</span> buflen;
<a name="l00161"></a>00161 
<a name="l00162"></a>00162   <span class="keywordflow">if</span> ( conn-&gt;readingbuf == NULL )
<a name="l00163"></a>00163   {
<a name="l00164"></a>00164     buf = netconn_recv( conn );
<a name="l00165"></a>00165     <span class="keywordflow">if</span> ( buf == NULL )
<a name="l00166"></a>00166       <span class="keywordflow">return</span> 0;
<a name="l00167"></a>00167 
<a name="l00168"></a>00168     buflen = netbuf_len( buf );
<a name="l00169"></a>00169     <span class="comment">/* copy the contents of the received buffer into</span>
<a name="l00170"></a>00170 <span class="comment">    the supplied memory pointer mem */</span>
<a name="l00171"></a>00171     netbuf_copy( buf, data, length );
<a name="l00172"></a>00172 
<a name="l00173"></a>00173     <span class="comment">// Test to see if the buffer is done, or needs to be saved</span>
<a name="l00174"></a>00174     <span class="keywordflow">if</span> ( buflen &lt;= length )
<a name="l00175"></a>00175     {
<a name="l00176"></a>00176       netbuf_delete( buf );
<a name="l00177"></a>00177     }
<a name="l00178"></a>00178     <span class="keywordflow">else</span>
<a name="l00179"></a>00179     {
<a name="l00180"></a>00180       conn-&gt;readingbuf = buf;
<a name="l00181"></a>00181       conn-&gt;readingoffset = length;
<a name="l00182"></a>00182       buflen = length;
<a name="l00183"></a>00183     }
<a name="l00184"></a>00184   }
<a name="l00185"></a>00185   <span class="keywordflow">else</span>
<a name="l00186"></a>00186   {
<a name="l00187"></a>00187     buf = conn-&gt;readingbuf;
<a name="l00188"></a>00188     buflen = netbuf_len( buf ) - conn-&gt;readingoffset;
<a name="l00189"></a>00189     netbuf_copy_partial( buf, data, length, conn-&gt;readingoffset );
<a name="l00190"></a>00190 
<a name="l00191"></a>00191     <span class="keywordflow">if</span> ( buflen &lt;= length )
<a name="l00192"></a>00192     {
<a name="l00193"></a>00193       netbuf_delete( buf );
<a name="l00194"></a>00194       conn-&gt;readingbuf = NULL;
<a name="l00195"></a>00195     }  
<a name="l00196"></a>00196     <span class="keywordflow">else</span>
<a name="l00197"></a>00197     {
<a name="l00198"></a>00198       conn-&gt;readingoffset += length;
<a name="l00199"></a>00199       buflen = length;
<a name="l00200"></a>00200     }
<a name="l00201"></a>00201   }
<a name="l00202"></a>00202 
<a name="l00203"></a>00203   <span class="keywordflow">return</span> buflen;
<a name="l00204"></a>00204 }
<a name="l00205"></a>00205 <span class="comment"></span>
<a name="l00206"></a>00206 <span class="comment">/** </span>
<a name="l00207"></a>00207 <span class="comment">  Read a line from a TCP socket terminated by CR LF (0x0D 0x0A).  </span>
<a name="l00208"></a>00208 <span class="comment">  Make sure you have an open socket before trying to read from it.</span>
<a name="l00209"></a>00209 <span class="comment">  @param socket A pointer to the existing socket.</span>
<a name="l00210"></a>00210 <span class="comment">  @param data A pointer to the buffer to read to.</span>
<a name="l00211"></a>00211 <span class="comment">  @param length An integer specifying the maximum length in bytes to read.</span>
<a name="l00212"></a>00212 <span class="comment">  @return An integer: length of data read if successful, zero on failure.</span>
<a name="l00213"></a>00213 <span class="comment">  @see Socket(), SocketRead(), SocketClose()</span>
<a name="l00214"></a>00214 <span class="comment">*/</span>
<a name="l00215"></a>00215 
<a name="l00216"></a><a class="code" href="group___sockets.html#gabf4d267c62d67bd596a22daea799662">00216</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#gabf4d267c62d67bd596a22daea799662" title="Read a line from a TCP socket terminated by CR LF (0x0D 0x0A).">SocketReadLine</a>( <span class="keywordtype">void</span>* socket, <span class="keywordtype">char</span>* data, <span class="keywordtype">int</span> length )
<a name="l00217"></a>00217 {
<a name="l00218"></a>00218   <span class="keywordtype">int</span> readLength;
<a name="l00219"></a>00219   <span class="keywordtype">int</span> lineLength = -1;
<a name="l00220"></a>00220   <span class="comment">//int terminated = false;</span>
<a name="l00221"></a>00221   data--;
<a name="l00222"></a>00222 
<a name="l00223"></a>00223   <span class="comment">// Upon entering, data points to char prior to buffer, length is -1</span>
<a name="l00224"></a>00224   <span class="keywordflow">do</span> 
<a name="l00225"></a>00225   {
<a name="l00226"></a>00226     data++;
<a name="l00227"></a>00227     <span class="comment">// here data points to where byte will be written</span>
<a name="l00228"></a>00228     lineLength++;
<a name="l00229"></a>00229     <span class="comment">// linelength now reflects true number of bytes</span>
<a name="l00230"></a>00230     readLength = <a class="code" href="group___sockets.html#g838d1ceaf477b3496a9fe4adf8d28147" title="Read from a TCP socket.">SocketRead</a>( socket, data, 1 );
<a name="l00231"></a>00231     <span class="comment">// here, if readlength == 1, data has a new char in next position, linelength is one off,</span>
<a name="l00232"></a>00232     <span class="comment">//       if readlength == 0, data had no new char and linelength is right</span>
<a name="l00233"></a>00233   } <span class="keywordflow">while</span> ( ( readLength == 1 ) &amp;&amp; ( lineLength &lt; length - 1 ) &amp;&amp; ( *data != <span class="charliteral">'\n'</span> ) );
<a name="l00234"></a>00234 
<a name="l00235"></a>00235   <span class="comment">// here, length is corrected if there was a character  </span>
<a name="l00236"></a>00236   <span class="keywordflow">if</span> ( readLength == 1 )
<a name="l00237"></a>00237     lineLength++;
<a name="l00238"></a>00238   
<a name="l00239"></a>00239   <span class="keywordflow">return</span> lineLength;
<a name="l00240"></a>00240 }
<a name="l00241"></a>00241 
<a name="l00242"></a>00242 <span class="comment"></span>
<a name="l00243"></a>00243 <span class="comment">/** </span>
<a name="l00244"></a>00244 <span class="comment">  Write to a TCP socket.</span>
<a name="l00245"></a>00245 <span class="comment">  Not surprisingly, we need an existing socket before we can write to it.</span>
<a name="l00246"></a>00246 <span class="comment"></span>
<a name="l00247"></a>00247 <span class="comment">  @param socket A pointer to the existing socket.</span>
<a name="l00248"></a>00248 <span class="comment">  @param data A pointer to the buffer to write from.</span>
<a name="l00249"></a>00249 <span class="comment">  @param length An integer specifying the length in bytes of how much data should be written.</span>
<a name="l00250"></a>00250 <span class="comment">  @return An integer: 'length written' if successful, 0 on failure.</span>
<a name="l00251"></a>00251 <span class="comment">  @see Socket()</span>
<a name="l00252"></a>00252 <span class="comment"></span>
<a name="l00253"></a>00253 <span class="comment">  \par Example</span>
<a name="l00254"></a>00254 <span class="comment">  \code</span>
<a name="l00255"></a>00255 <span class="comment">  // we should already have created a socket with Socket()</span>
<a name="l00256"></a>00256 <span class="comment">  struct netconn* sock = Socket( addr, 10101 );</span>
<a name="l00257"></a>00257 <span class="comment">  int length_written = SocketWrite( sock, data, length )</span>
<a name="l00258"></a>00258 <span class="comment">  // if 0 bytes were written, there was some sort of error</span>
<a name="l00259"></a>00259 <span class="comment">  if( length_written == 0 )</span>
<a name="l00260"></a>00260 <span class="comment">    SocketClose( sock );</span>
<a name="l00261"></a>00261 <span class="comment">  \endcode</span>
<a name="l00262"></a>00262 <span class="comment">*/</span>
<a name="l00263"></a><a class="code" href="group___sockets.html#g1031bc0757e65ea265deb5dc3ded3029">00263</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#g1031bc0757e65ea265deb5dc3ded3029" title="Write to a TCP socket.">SocketWrite</a>( <span class="keywordtype">void</span>* socket, <span class="keywordtype">char</span>* data, <span class="keywordtype">int</span> length )
<a name="l00264"></a>00264 {
<a name="l00265"></a>00265   <span class="keywordtype">int</span> err = netconn_write( (<span class="keyword">struct</span> netconn *)socket, data, length, NETCONN_COPY);
<a name="l00266"></a>00266   <span class="keywordflow">if</span> ( err != ERR_OK )
<a name="l00267"></a>00267     <span class="keywordflow">return</span> 0;
<a name="l00268"></a>00268   <span class="keywordflow">else</span>
<a name="l00269"></a>00269     <span class="keywordflow">return</span> length;
<a name="l00270"></a>00270 }
<a name="l00271"></a>00271 <span class="comment"></span>
<a name="l00272"></a>00272 <span class="comment">/** </span>
<a name="l00273"></a>00273 <span class="comment">  Close an existing TCP socket.</span>
<a name="l00274"></a>00274 <span class="comment">  Anytime you get an error when trying to read or write, it's best to close the socket and reopen</span>
<a name="l00275"></a>00275 <span class="comment">  it to make sure that the connection is corrently configured.</span>
<a name="l00276"></a>00276 <span class="comment">  @param socket A pointer to the existing socket.</span>
<a name="l00277"></a>00277 <span class="comment">  @return void</span>
<a name="l00278"></a>00278 <span class="comment">  @see Socket()</span>
<a name="l00279"></a>00279 <span class="comment"></span>
<a name="l00280"></a>00280 <span class="comment">  \par Example</span>
<a name="l00281"></a>00281 <span class="comment">  \code</span>
<a name="l00282"></a>00282 <span class="comment">  // we should already have created a socket 'sock' with Socket().</span>
<a name="l00283"></a>00283 <span class="comment">  struct netconn* sock = Socket( addr, 10101 );</span>
<a name="l00284"></a>00284 <span class="comment">  // now close it</span>
<a name="l00285"></a>00285 <span class="comment">  SocketClose( sock )</span>
<a name="l00286"></a>00286 <span class="comment">  \endcode</span>
<a name="l00287"></a>00287 <span class="comment">*/</span>
<a name="l00288"></a><a class="code" href="group___sockets.html#geab922d85a99bd7577f5e5b54628a5b4">00288</a> <span class="keywordtype">void</span> <a class="code" href="group___sockets.html#geab922d85a99bd7577f5e5b54628a5b4" title="Close an existing TCP socket.">SocketClose</a>( <span class="keywordtype">void</span>* socket )
<a name="l00289"></a>00289 { 
<a name="l00290"></a>00290   <span class="comment">// Make sure there is no buffer lying around</span>
<a name="l00291"></a>00291   <span class="keyword">struct </span>netconn *conn = socket;
<a name="l00292"></a>00292   <span class="keywordflow">if</span> ( conn-&gt;readingbuf != NULL )
<a name="l00293"></a>00293   {   
<a name="l00294"></a>00294     netbuf_delete( conn-&gt;readingbuf );
<a name="l00295"></a>00295     conn-&gt;readingbuf = NULL;
<a name="l00296"></a>00296   }
<a name="l00297"></a>00297 
<a name="l00298"></a>00298   netconn_close( (<span class="keyword">struct</span> netconn *)socket );
<a name="l00299"></a>00299   netconn_delete( (<span class="keyword">struct</span> netconn *)socket );
<a name="l00300"></a>00300   <span class="keywordflow">return</span>;
<a name="l00301"></a>00301 }
<a name="l00302"></a>00302 <span class="comment"></span>
<a name="l00303"></a>00303 <span class="comment">/** </span>
<a name="l00304"></a>00304 <span class="comment">  Create a new TCP server socket and start listening for connections.</span>
<a name="l00305"></a>00305 <span class="comment">  @param port An integer specifying the port to listen on.</span>
<a name="l00306"></a>00306 <span class="comment">  @return A pointer to the socket created.</span>
<a name="l00307"></a>00307 <span class="comment">  @see ServerSocketAccept( )</span>
<a name="l00308"></a>00308 <span class="comment">  </span>
<a name="l00309"></a>00309 <span class="comment">  \par Example</span>
<a name="l00310"></a>00310 <span class="comment">  \code</span>
<a name="l00311"></a>00311 <span class="comment">  // create a socket and start listening on port 10101</span>
<a name="l00312"></a>00312 <span class="comment">  struct netconn* server = ServerSocket( 10101 );</span>
<a name="l00313"></a>00313 <span class="comment">  // ServerSocketAccept( ) will block until an incoming connection is made</span>
<a name="l00314"></a>00314 <span class="comment">  struct netconn* newConnection = ServerSocketAccept( server );</span>
<a name="l00315"></a>00315 <span class="comment">  // now grab the data from the new connection</span>
<a name="l00316"></a>00316 <span class="comment">  \endcode</span>
<a name="l00317"></a>00317 <span class="comment">*/</span>
<a name="l00318"></a><a class="code" href="group___sockets.html#g19a37ffe799e0d2de090a24a03e38cb7">00318</a> <span class="keywordtype">void</span>* <a class="code" href="group___sockets.html#g19a37ffe799e0d2de090a24a03e38cb7" title="Create a new TCP server socket and start listening for connections.">ServerSocket</a>( <span class="keywordtype">int</span> port )
<a name="l00319"></a>00319 {
<a name="l00320"></a>00320   <a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b" title="Sets whether the Network subsystem is active.">Network_SetActive</a>( 1 );
<a name="l00321"></a>00321 
<a name="l00322"></a>00322   <span class="keyword">struct </span>netconn *conn;
<a name="l00323"></a>00323 
<a name="l00324"></a>00324   conn = netconn_new( NETCONN_TCP );
<a name="l00325"></a>00325   <span class="keywordflow">if</span> ( conn != NULL )
<a name="l00326"></a>00326   { 
<a name="l00327"></a>00327     netconn_bind( conn, 0, port );
<a name="l00328"></a>00328     netconn_listen( conn );
<a name="l00329"></a>00329   }
<a name="l00330"></a>00330 
<a name="l00331"></a>00331   <span class="keywordflow">return</span> conn;
<a name="l00332"></a>00332 }
<a name="l00333"></a>00333 <span class="comment"></span>
<a name="l00334"></a>00334 <span class="comment">/** </span>
<a name="l00335"></a>00335 <span class="comment">  Accept an incoming connection to a ServerSocket that you have created.  This</span>
<a name="l00336"></a>00336 <span class="comment">  function will block until a new connection is waiting to be serviced.  It returns</span>
<a name="l00337"></a>00337 <span class="comment">  a regular socket on which you can use SocketWrite(), SocketRead() and SocketClose().</span>
<a name="l00338"></a>00338 <span class="comment">  @param serverSocket a pointer to a ServerSocket that you created</span>
<a name="l00339"></a>00339 <span class="comment">  @return a pointer to the new socket created to handle the connection</span>
<a name="l00340"></a>00340 <span class="comment">  @see ServerSocket(), SocketWrite(), SocketRead(), SocketClose()</span>
<a name="l00341"></a>00341 <span class="comment">*/</span>
<a name="l00342"></a><a class="code" href="group___sockets.html#g17066cbe7e4510e8c89bba318140ff30">00342</a> <span class="keywordtype">void</span>* <a class="code" href="group___sockets.html#g17066cbe7e4510e8c89bba318140ff30" title="Accept an incoming connection to a ServerSocket that you have created.">ServerSocketAccept</a>( <span class="keywordtype">void</span>* serverSocket )
<a name="l00343"></a>00343 {
<a name="l00344"></a>00344   <span class="keyword">struct </span>netconn *conn;
<a name="l00345"></a>00345   conn = netconn_accept( (<span class="keyword">struct</span> netconn *)serverSocket );
<a name="l00346"></a>00346   <span class="comment">// This is our addition to the conn structure to help with reading</span>
<a name="l00347"></a>00347   <span class="keywordflow">if</span> ( conn != NULL )
<a name="l00348"></a>00348     conn-&gt;readingbuf = NULL;
<a name="l00349"></a>00349   <span class="keywordflow">return</span> conn;
<a name="l00350"></a>00350 }
<a name="l00351"></a>00351 <span class="comment"></span>
<a name="l00352"></a>00352 <span class="comment">/** </span>
<a name="l00353"></a>00353 <span class="comment">  Close a ServerSocket that you have created.</span>
<a name="l00354"></a>00354 <span class="comment">  @param serverSocket A pointer to a ServerSocket.</span>
<a name="l00355"></a>00355 <span class="comment">  @return 0 if the process was successful.</span>
<a name="l00356"></a>00356 <span class="comment">  @see ServerSocket()</span>
<a name="l00357"></a>00357 <span class="comment">  </span>
<a name="l00358"></a>00358 <span class="comment">  \par Example</span>
<a name="l00359"></a>00359 <span class="comment">  \code</span>
<a name="l00360"></a>00360 <span class="comment">  // we created a server socket at some point</span>
<a name="l00361"></a>00361 <span class="comment">  struct netconn* server = ServerSocket( 10101 );</span>
<a name="l00362"></a>00362 <span class="comment">  // now close it</span>
<a name="l00363"></a>00363 <span class="comment">  ServerSocketClose( server );</span>
<a name="l00364"></a>00364 <span class="comment">  \endcode</span>
<a name="l00365"></a>00365 <span class="comment">*/</span>
<a name="l00366"></a><a class="code" href="group___sockets.html#gd698a1f1aa9b0f2864056a0790417179">00366</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#gd698a1f1aa9b0f2864056a0790417179" title="Close a ServerSocket that you have created.">ServerSocketClose</a>( <span class="keywordtype">void</span>* serverSocket )
<a name="l00367"></a>00367 {
<a name="l00368"></a>00368   <span class="comment">// netconn_close( serverSocket );</span>
<a name="l00369"></a>00369   netconn_delete( serverSocket );
<a name="l00370"></a>00370   <span class="keywordflow">return</span> 0;
<a name="l00371"></a>00371 }
<a name="l00372"></a>00372 <span class="comment"></span>
<a name="l00373"></a>00373 <span class="comment">/** </span>
<a name="l00374"></a>00374 <span class="comment">  Create a socket to read and write UDP packets.</span>
<a name="l00375"></a>00375 <span class="comment">  @param port An integer specifying the port to open.</span>
<a name="l00376"></a>00376 <span class="comment">  @return a pointer to the socket created.</span>
<a name="l00377"></a>00377 <span class="comment">  @see DatagramSocketSend( ), DatagramSocketReceive( )</span>
<a name="l00378"></a>00378 <span class="comment">  </span>
<a name="l00379"></a>00379 <span class="comment">  \par Example</span>
<a name="l00380"></a>00380 <span class="comment">  \code</span>
<a name="l00381"></a>00381 <span class="comment">  // create a new UDP socket on port 10101</span>
<a name="l00382"></a>00382 <span class="comment">  struct netconn* udpSocket = DatagramSocket( 10101 );</span>
<a name="l00383"></a>00383 <span class="comment">  // now read and write to it using DatagramSocketSend( ) and DatagramSocketReceive( )</span>
<a name="l00384"></a>00384 <span class="comment">  \endcode</span>
<a name="l00385"></a>00385 <span class="comment">*/</span>
<a name="l00386"></a><a class="code" href="group___sockets.html#g2cd3724da41c8c8235fa648a6fc9bcce">00386</a> <span class="keywordtype">void</span>* <a class="code" href="group___sockets.html#g2cd3724da41c8c8235fa648a6fc9bcce" title="Create a socket to read and write UDP packets.">DatagramSocket</a>( <span class="keywordtype">int</span> port )
<a name="l00387"></a>00387 {
<a name="l00388"></a>00388   <a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b" title="Sets whether the Network subsystem is active.">Network_SetActive</a>( 1 );
<a name="l00389"></a>00389 
<a name="l00390"></a>00390   <span class="keyword">struct </span>netconn *conn;
<a name="l00391"></a>00391 
<a name="l00392"></a>00392   conn = netconn_new( NETCONN_UDP );
<a name="l00393"></a>00393   <span class="keywordflow">if</span>( conn == NULL || conn-&gt;err != ERR_OK )
<a name="l00394"></a>00394     <span class="keywordflow">return</span> NULL;
<a name="l00395"></a>00395   <span class="comment">// This is our addition to the conn structure to help with reading</span>
<a name="l00396"></a>00396   conn-&gt;readingbuf = NULL;
<a name="l00397"></a>00397 
<a name="l00398"></a>00398   <span class="comment">// hook it up</span>
<a name="l00399"></a>00399   netconn_bind( conn, NULL, port );
<a name="l00400"></a>00400 
<a name="l00401"></a>00401   <span class="keywordflow">return</span> conn;
<a name="l00402"></a>00402 }
<a name="l00403"></a>00403 <span class="comment"></span>
<a name="l00404"></a>00404 <span class="comment">/** </span>
<a name="l00405"></a>00405 <span class="comment">  Send a UDP packet to a specified address.</span>
<a name="l00406"></a>00406 <span class="comment">  @param datagramSocket A pointer to the DatagramSocket() you're using to write.</span>
<a name="l00407"></a>00407 <span class="comment">  @param address An integer specifying the IP address to write to.</span>
<a name="l00408"></a>00408 <span class="comment">  @param port An integer specifying the port to write to.</span>
<a name="l00409"></a>00409 <span class="comment">  @param data A pointer to the packet to send.</span>
<a name="l00410"></a>00410 <span class="comment">  @param length An integer specifying the number of bytes in the packet being sent.</span>
<a name="l00411"></a>00411 <span class="comment">  @return An integer corresponding to the number of bytes successfully written.</span>
<a name="l00412"></a>00412 <span class="comment">  @see DatagramSocket( )</span>
<a name="l00413"></a>00413 <span class="comment">  </span>
<a name="l00414"></a>00414 <span class="comment">  \par Example</span>
<a name="l00415"></a>00415 <span class="comment">  \code</span>
<a name="l00416"></a>00416 <span class="comment">  struct netconn* udpSocket = DatagramSocket( 10101 ); // our socket</span>
<a name="l00417"></a>00417 <span class="comment">  int address = IP_ADDRESS( 192, 168, 0, 200 );</span>
<a name="l00418"></a>00418 <span class="comment">  int sent = DatagramSocketSend( udpSocket, address, 10101, myBuffer, myLength );</span>
<a name="l00419"></a>00419 <span class="comment">  \endcode</span>
<a name="l00420"></a>00420 <span class="comment">*/</span>
<a name="l00421"></a><a class="code" href="group___sockets.html#g5aa01e1403bafbfca35746bcd44a5c83">00421</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#g5aa01e1403bafbfca35746bcd44a5c83" title="Send a UDP packet to a specified address.">DatagramSocketSend</a>( <span class="keywordtype">void</span>* datagramSocket, <span class="keywordtype">int</span> address, <span class="keywordtype">int</span> port, <span class="keywordtype">void</span>* data, <span class="keywordtype">int</span> length )
<a name="l00422"></a>00422 { 
<a name="l00423"></a>00423   <span class="keyword">struct </span>netconn *conn = (<span class="keyword">struct </span>netconn *)datagramSocket;
<a name="l00424"></a>00424   <span class="keyword">struct </span>netbuf *buf;
<a name="l00425"></a>00425   <span class="keyword">struct </span>ip_addr remote_addr;
<a name="l00426"></a>00426   <span class="keywordtype">int</span> lengthsent = 0;
<a name="l00427"></a>00427 
<a name="l00428"></a>00428   remote_addr.addr = htonl(address);
<a name="l00429"></a>00429   <span class="keywordflow">if</span>( ERR_OK != netconn_connect(conn, &amp;remote_addr, port) )
<a name="l00430"></a>00430     <span class="keywordflow">return</span> lengthsent;
<a name="l00431"></a>00431 
<a name="l00432"></a>00432   <span class="comment">// create a buffer</span>
<a name="l00433"></a>00433   buf = netbuf_new();
<a name="l00434"></a>00434   <span class="keywordflow">if</span>( buf != NULL )
<a name="l00435"></a>00435   {
<a name="l00436"></a>00436     netbuf_ref( buf, data, length); <span class="comment">// make the buffer point to the data that should be sent</span>
<a name="l00437"></a>00437     <span class="keywordflow">if</span>( ERR_OK != netconn_send( conn, buf) ) <span class="comment">// send the data</span>
<a name="l00438"></a>00438     {
<a name="l00439"></a>00439       netbuf_delete(buf);
<a name="l00440"></a>00440       <span class="keywordflow">return</span> 0;
<a name="l00441"></a>00441     }
<a name="l00442"></a>00442     lengthsent = length;
<a name="l00443"></a>00443     netbuf_delete(buf); <span class="comment">// deallocate the buffer</span>
<a name="l00444"></a>00444   }
<a name="l00445"></a>00445 
<a name="l00446"></a>00446   <span class="keywordflow">return</span> lengthsent;
<a name="l00447"></a>00447 }
<a name="l00448"></a>00448 <span class="comment"></span>
<a name="l00449"></a>00449 <span class="comment">/** </span>
<a name="l00450"></a>00450 <span class="comment">  Receive a UDP packet.  </span>
<a name="l00451"></a>00451 <span class="comment">  This function will block until a packet is received. The address and port of the </span>
<a name="l00452"></a>00452 <span class="comment">  sender are returned in the locations pointed to by the address and port parameters.  </span>
<a name="l00453"></a>00453 <span class="comment">  If the incoming packet is larger than the specified size of the buffer, it will</span>
<a name="l00454"></a>00454 <span class="comment">  be truncated.</span>
<a name="l00455"></a>00455 <span class="comment">  @param datagramSocket A pointer to the DatagramSocket() you're using to read.</span>
<a name="l00456"></a>00456 <span class="comment">  @param incomingPort An integer specifying the port to listen on.</span>
<a name="l00457"></a>00457 <span class="comment">  @param address A pointer to the IP address that sent the packet.</span>
<a name="l00458"></a>00458 <span class="comment">  @param port A pointer to the port of the sender.</span>
<a name="l00459"></a>00459 <span class="comment">  @param data A pointer to the buffer to read into.</span>
<a name="l00460"></a>00460 <span class="comment">  @param length An integer specifying the number of bytes in the packet being read.</span>
<a name="l00461"></a>00461 <span class="comment">  @return An integer corresponding to the number of bytes successfully read.</span>
<a name="l00462"></a>00462 <span class="comment">  @see DatagramSocket( )</span>
<a name="l00463"></a>00463 <span class="comment">  </span>
<a name="l00464"></a>00464 <span class="comment">  \par Example</span>
<a name="l00465"></a>00465 <span class="comment">  \code</span>
<a name="l00466"></a>00466 <span class="comment">  struct netconn* udpSocket = DatagramSocket( 10101 ); // our socket</span>
<a name="l00467"></a>00467 <span class="comment">  int address, port;</span>
<a name="l00468"></a>00468 <span class="comment">  int sent = DatagramSocketReceive( udpSocket, &amp;address, &amp;port, myBuffer, myLength );</span>
<a name="l00469"></a>00469 <span class="comment">  \endcode</span>
<a name="l00470"></a>00470 <span class="comment">*/</span>
<a name="l00471"></a><a class="code" href="group___sockets.html#ge810fd22358d4358b214bb99c20f363f">00471</a> <span class="keywordtype">int</span> <a class="code" href="group___sockets.html#ge810fd22358d4358b214bb99c20f363f" title="Receive a UDP packet.">DatagramSocketReceive</a>( <span class="keywordtype">void</span>* datagramSocket, <span class="keywordtype">int</span> incomingPort, <span class="keywordtype">int</span>* address, <span class="keywordtype">int</span>* port, <span class="keywordtype">void</span>* data, <span class="keywordtype">int</span> length )
<a name="l00472"></a>00472 {
<a name="l00473"></a>00473   <span class="keyword">struct </span>netconn *conn = (<span class="keyword">struct </span>netconn*)datagramSocket;
<a name="l00474"></a>00474   <span class="keyword">struct </span>netbuf *buf;
<a name="l00475"></a>00475   <span class="keyword">struct </span>ip_addr *addr;
<a name="l00476"></a>00476   <span class="keywordtype">int</span> buflen = 0;
<a name="l00477"></a>00477 
<a name="l00478"></a>00478   <span class="keywordflow">if</span>( ERR_OK != netconn_bind( conn, IP_ADDR_ANY, incomingPort ) )
<a name="l00479"></a>00479     <span class="keywordflow">return</span> buflen;
<a name="l00480"></a>00480     
<a name="l00481"></a>00481   buf = netconn_recv( conn );
<a name="l00482"></a>00482   <span class="keywordflow">if</span>( buf != NULL )
<a name="l00483"></a>00483   {
<a name="l00484"></a>00484     buflen = netbuf_len( buf );
<a name="l00485"></a>00485     <span class="comment">// copy the contents of the received buffer into</span>
<a name="l00486"></a>00486     <span class="comment">//the supplied memory pointer </span>
<a name="l00487"></a>00487     netbuf_copy(buf, data, length);
<a name="l00488"></a>00488     addr = netbuf_fromaddr(buf);
<a name="l00489"></a>00489     *port = netbuf_fromport(buf);
<a name="l00490"></a>00490     *address = ntohl( addr-&gt;addr );
<a name="l00491"></a>00491     netbuf_delete(buf);
<a name="l00492"></a>00492   }
<a name="l00493"></a>00493 
<a name="l00494"></a>00494   <span class="comment">/* if the length of the received data is larger than</span>
<a name="l00495"></a>00495 <span class="comment">  len, this data is discarded and we return len.</span>
<a name="l00496"></a>00496 <span class="comment">  otherwise we return the actual length of the received</span>
<a name="l00497"></a>00497 <span class="comment">  data */</span>
<a name="l00498"></a>00498   <span class="keywordflow">if</span>(length &gt; buflen)
<a name="l00499"></a>00499     <span class="keywordflow">return</span> buflen;
<a name="l00500"></a>00500   <span class="keywordflow">else</span>
<a name="l00501"></a>00501     <span class="keywordflow">return</span> length;
<a name="l00502"></a>00502 }
<a name="l00503"></a>00503 <span class="comment"></span>
<a name="l00504"></a>00504 <span class="comment">/** </span>
<a name="l00505"></a>00505 <span class="comment">  Close a DatagramSocket().</span>
<a name="l00506"></a>00506 <span class="comment">  @param socket A pointer to the DatagramSocket() to close.</span>
<a name="l00507"></a>00507 <span class="comment">  @see DatagramSocket( )</span>
<a name="l00508"></a>00508 <span class="comment">  </span>
<a name="l00509"></a>00509 <span class="comment">  \par Example</span>
<a name="l00510"></a>00510 <span class="comment">  \code</span>
<a name="l00511"></a>00511 <span class="comment">  struct netconn* udpSocket = DatagramSocket( 10101 ); // create our socket</span>
<a name="l00512"></a>00512 <span class="comment">  // now close it</span>
<a name="l00513"></a>00513 <span class="comment">  DatagramSocketClose( udpSocket );</span>
<a name="l00514"></a>00514 <span class="comment">  \endcode</span>
<a name="l00515"></a>00515 <span class="comment">*/</span>
<a name="l00516"></a><a class="code" href="group___sockets.html#g2d63455f4c8feff3399c73f70e3300b7">00516</a> <span class="keywordtype">void</span> <a class="code" href="group___sockets.html#g2d63455f4c8feff3399c73f70e3300b7" title="Close a DatagramSocket().">DatagramSocketClose</a>( <span class="keywordtype">void</span>* socket )
<a name="l00517"></a>00517 {
<a name="l00518"></a>00518   netconn_close( socket );
<a name="l00519"></a>00519   netconn_delete( socket );
<a name="l00520"></a>00520 }
<a name="l00521"></a>00521 <span class="comment"></span>
<a name="l00522"></a>00522 <span class="comment">/** @}</span>
<a name="l00523"></a>00523 <span class="comment">*/</span>
<a name="l00524"></a>00524 <span class="comment"></span>
<a name="l00525"></a>00525 <span class="comment">/** \defgroup Network</span>
<a name="l00526"></a>00526 <span class="comment">  The Network subsystem manages the Ethernet controller.</span>
<a name="l00527"></a>00527 <span class="comment">  </span>
<a name="l00528"></a>00528 <span class="comment">  Like any other network enabled device, the Make Controller has an IP address, net mask and gateway.</span>
<a name="l00529"></a>00529 <span class="comment">  - The default IP address is 192.168.0.200</span>
<a name="l00530"></a>00530 <span class="comment">  - The default mask is 255.255.255.0</span>
<a name="l00531"></a>00531 <span class="comment">  - The default gateway 192.168.0.1</span>
<a name="l00532"></a>00532 <span class="comment">  </span>
<a name="l00533"></a>00533 <span class="comment">  You can set any of these values manually, or use DHCP to get them automatically.</span>
<a name="l00534"></a>00534 <span class="comment">  </span>
<a name="l00535"></a>00535 <span class="comment">  \section MAC</span>
<a name="l00536"></a>00536 <span class="comment">  The Make Controller's MAC address defaults to AC.DE.48.55.x.y where x &amp; y are calculated from the </span>
<a name="l00537"></a>00537 <span class="comment">  unit's serial number, handled by the \ref System subsystem.</span>
<a name="l00538"></a>00538 <span class="comment">  </span>
<a name="l00539"></a>00539 <span class="comment">  \section webserver Web Server</span>
<a name="l00540"></a>00540 <span class="comment">  The Make Controller Kit can also act as a web server.  The demo web server running on the Make Controller</span>
<a name="l00541"></a>00541 <span class="comment">  displays some stats about the board's current state through a web interface.  It is intended mainly as</span>
<a name="l00542"></a>00542 <span class="comment">  a starting point for more useful web applications.  See the source in webserver.c.</span>
<a name="l00543"></a>00543 <span class="comment"></span>
<a name="l00544"></a>00544 <span class="comment">  \ingroup Controller</span>
<a name="l00545"></a>00545 <span class="comment">  @{</span>
<a name="l00546"></a>00546 <span class="comment">*/</span>
<a name="l00547"></a>00547 <span class="comment"></span>
<a name="l00548"></a>00548 <span class="comment">/**</span>
<a name="l00549"></a>00549 <span class="comment">  Sets whether the Network subsystem is active.  </span>
<a name="l00550"></a>00550 <span class="comment">  This fires up the networking system on the Make Controller, and will not return until a network is found,</span>
<a name="l00551"></a>00551 <span class="comment">  ie. a network cable is plugged in.</span>
<a name="l00552"></a>00552 <span class="comment">  @param state An integer specifying the active state - 1 (active) or 0 (inactive).</span>
<a name="l00553"></a>00553 <span class="comment">  @return 0 on success.</span>
<a name="l00554"></a>00554 <span class="comment">*/</span>
<a name="l00555"></a><a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b">00555</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b" title="Sets whether the Network subsystem is active.">Network_SetActive</a>( <span class="keywordtype">int</span> state )
<a name="l00556"></a>00556 {
<a name="l00557"></a>00557   <span class="keywordflow">if</span> ( state ) 
<a name="l00558"></a>00558   {
<a name="l00559"></a>00559     <span class="keywordflow">if</span>( Network == NULL )
<a name="l00560"></a>00560     {
<a name="l00561"></a>00561       Network = <a class="code" href="group___utils.html#g95923aa748602fa0330903fca05ca892" title="Same as Malloc, but keeps trying until it succeeds.">MallocWait</a>( <span class="keyword">sizeof</span>( NetworkStruct ), 100 );
<a name="l00562"></a>00562       Network-&gt;pending = 1;
<a name="l00563"></a>00563       Network-&gt;TcpRequested = 0;
<a name="l00564"></a>00564       Network-&gt;WebServerTaskPtr = NULL;
<a name="l00565"></a>00565 
<a name="l00566"></a>00566       <span class="keywordflow">if</span>( !<a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>() ) <span class="comment">// if we don't have good values, set the defaults</span>
<a name="l00567"></a>00567         Network_SetDefaults( );
<a name="l00568"></a>00568       <span class="keywordflow">else</span> <span class="comment">// load the values from EEPROM</span>
<a name="l00569"></a>00569       {
<a name="l00570"></a>00570         <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_ADDRESS, (uchar*)&amp;Network-&gt;TempIpAddress, 4 );
<a name="l00571"></a>00571         <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_GATEWAY, (uchar*)&amp;Network-&gt;TempGateway, 4 );
<a name="l00572"></a>00572         <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_MASK, (uchar*)&amp;Network-&gt;TempMask, 4 );
<a name="l00573"></a>00573       }
<a name="l00574"></a>00574 
<a name="l00575"></a>00575       Network-&gt;OscUdpListenPort = NetworkOsc_GetUdpListenPort( );
<a name="l00576"></a>00576       Network-&gt;OscUdpSendPort = NetworkOsc_GetUdpSendPort( );
<a name="l00577"></a>00577       <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_TCP_OUT_ADDRESS, (uchar*)&amp;Network-&gt;TcpOutAddress, 4 );
<a name="l00578"></a>00578       <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_TCP_OUT_PORT, (uchar*)&amp;Network-&gt;TcpOutPort, 4 );
<a name="l00579"></a>00579       Network_Init();
<a name="l00580"></a>00580     }
<a name="l00581"></a>00581   }
<a name="l00582"></a>00582   <span class="keywordflow">else</span> 
<a name="l00583"></a>00583   {
<a name="l00584"></a>00584     <span class="keywordflow">if</span>( Network )
<a name="l00585"></a>00585     {
<a name="l00586"></a>00586       <a class="code" href="group___utils.html#g6b0be54448d6ce393134400f4b22fa97" title="Free memory from the heap.">Free</a>( Network );
<a name="l00587"></a>00587       Network = NULL;
<a name="l00588"></a>00588     }
<a name="l00589"></a>00589   }
<a name="l00590"></a>00590 
<a name="l00591"></a>00591   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00592"></a>00592 }
<a name="l00593"></a>00593 <span class="comment"></span>
<a name="l00594"></a>00594 <span class="comment">/**</span>
<a name="l00595"></a>00595 <span class="comment">  Returns the active state of the Network subsystem.</span>
<a name="l00596"></a>00596 <span class="comment">  @return State - 1 (active) or 0 (inactive).</span>
<a name="l00597"></a>00597 <span class="comment">*/</span>
<a name="l00598"></a><a class="code" href="group___network.html#gb1f4725187ab9011d327ed8e05e4746c">00598</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#gb1f4725187ab9011d327ed8e05e4746c" title="Returns the active state of the Network subsystem.">Network_GetActive</a>( <span class="keywordtype">void</span> )
<a name="l00599"></a>00599 {
<a name="l00600"></a>00600   <span class="keywordflow">if</span>( Network == NULL || Network_GetPending( ) )
<a name="l00601"></a>00601     <span class="keywordflow">return</span> 0;
<a name="l00602"></a>00602   <span class="keywordflow">else</span>
<a name="l00603"></a>00603     <span class="keywordflow">return</span> 1;
<a name="l00604"></a>00604 }
<a name="l00605"></a>00605 <span class="comment"></span>
<a name="l00606"></a>00606 <span class="comment">/**</span>
<a name="l00607"></a>00607 <span class="comment">  Set the IP address of the Make Controller.</span>
<a name="l00608"></a>00608 <span class="comment">  The IP address of the Make Controller, in dotted decimal form (xxx.xxx.xxx.xxx),</span>
<a name="l00609"></a>00609 <span class="comment">  can be set by passing in each of the numbers as a separate parameter.</span>
<a name="l00610"></a>00610 <span class="comment">  The default IP address of each Make Controller as it ships from the factory</span>
<a name="l00611"></a>00611 <span class="comment">  is 192.168.0.200.  </span>
<a name="l00612"></a>00612 <span class="comment"></span>
<a name="l00613"></a>00613 <span class="comment">  This value is stored in EEPROM, so it persists even after the board</span>
<a name="l00614"></a>00614 <span class="comment">  is powered down.</span>
<a name="l00615"></a>00615 <span class="comment"></span>
<a name="l00616"></a>00616 <span class="comment">  @param a0 An integer corresponding to the first of 4 numbers in the address.</span>
<a name="l00617"></a>00617 <span class="comment">  @param a1 An integer corresponding to the second of 4 numbers in the address.</span>
<a name="l00618"></a>00618 <span class="comment">  @param a2 An integer corresponding to the third of 4 numbers in the address.</span>
<a name="l00619"></a>00619 <span class="comment">  @param a3 An integer corresponding to the fourth of 4 numbers in the address.</span>
<a name="l00620"></a>00620 <span class="comment">  @return 0 on success.</span>
<a name="l00621"></a>00621 <span class="comment"></span>
<a name="l00622"></a>00622 <span class="comment">  \par Example</span>
<a name="l00623"></a>00623 <span class="comment">  \code</span>
<a name="l00624"></a>00624 <span class="comment">  // set the address to 192.168.0.23</span>
<a name="l00625"></a>00625 <span class="comment">  Network_SetAddress( 192, 168, 0, 23 );</span>
<a name="l00626"></a>00626 <span class="comment">  \endcode</span>
<a name="l00627"></a>00627 <span class="comment"></span>
<a name="l00628"></a>00628 <span class="comment">*/</span>
<a name="l00629"></a><a class="code" href="group___network.html#g8efe3e0915b89c461da231653b7bd3b7">00629</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#g8efe3e0915b89c461da231653b7bd3b7" title="Set the IP address of the Make Controller.">Network_SetAddress</a>( <span class="keywordtype">int</span> a0, <span class="keywordtype">int</span> a1, <span class="keywordtype">int</span> a2, <span class="keywordtype">int</span> a3 )
<a name="l00630"></a>00630 {
<a name="l00631"></a>00631   <span class="comment">// just store this address, since we're only going to do something with it in response to</span>
<a name="l00632"></a>00632   <span class="keywordflow">if</span>( !<a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>() )
<a name="l00633"></a>00633   {
<a name="l00634"></a>00634     Network_SetDefaults( );
<a name="l00635"></a>00635     <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00636"></a>00636   }
<a name="l00637"></a>00637   Network-&gt;TempIpAddress = NETIF_IP_ADDRESS( a0, a1, a2, a3 );
<a name="l00638"></a>00638   <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00639"></a>00639 
<a name="l00640"></a>00640   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00641"></a>00641 }
<a name="l00642"></a>00642 <span class="comment"></span>
<a name="l00643"></a>00643 <span class="comment">/**</span>
<a name="l00644"></a>00644 <span class="comment">  Set the network mask of the Make Controller on your local network.</span>
<a name="l00645"></a>00645 <span class="comment">  When on a subnet or local network, the network mask must be set in order</span>
<a name="l00646"></a>00646 <span class="comment">  for the gateway to route information to the board's IP address properly.</span>
<a name="l00647"></a>00647 <span class="comment">  The mask is commonly 255.255.255.0 for many home networks.</span>
<a name="l00648"></a>00648 <span class="comment">  Set the mask in dotted decimal form (xxx.xxx.xxx.xxx), passing in each </span>
<a name="l00649"></a>00649 <span class="comment">  number as a separate parameter.</span>
<a name="l00650"></a>00650 <span class="comment"></span>
<a name="l00651"></a>00651 <span class="comment">  This value is stored in EEPROM, so it persists even after the board</span>
<a name="l00652"></a>00652 <span class="comment">  is powered down.</span>
<a name="l00653"></a>00653 <span class="comment"></span>
<a name="l00654"></a>00654 <span class="comment">  @param a0 An integer corresponding to the first of 4 numbers in the mask.</span>
<a name="l00655"></a>00655 <span class="comment">  @param a1 An integer corresponding to the second of 4 numbers in the mask.</span>
<a name="l00656"></a>00656 <span class="comment">  @param a2 An integer corresponding to the third of 4 numbers in the mask.</span>
<a name="l00657"></a>00657 <span class="comment">  @param a3 An integer corresponding to the fourth of 4 numbers in the mask.</span>
<a name="l00658"></a>00658 <span class="comment">  @return 0 on success.</span>
<a name="l00659"></a>00659 <span class="comment"></span>
<a name="l00660"></a>00660 <span class="comment">  \par Example</span>
<a name="l00661"></a>00661 <span class="comment">  \code</span>
<a name="l00662"></a>00662 <span class="comment">  // set the mask to 255.255.255.254</span>
<a name="l00663"></a>00663 <span class="comment">  if( 0 != Network_SetMask( 255, 255, 255, 254 ) )</span>
<a name="l00664"></a>00664 <span class="comment">    // then there was a problem.</span>
<a name="l00665"></a>00665 <span class="comment">  \endcode</span>
<a name="l00666"></a>00666 <span class="comment">*/</span>
<a name="l00667"></a><a class="code" href="group___network.html#g8f1c006937cf5985de44cf8cd0751642">00667</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#g8f1c006937cf5985de44cf8cd0751642" title="Set the network mask of the Make Controller on your local network.">Network_SetMask</a>( <span class="keywordtype">int</span> a0, <span class="keywordtype">int</span> a1, <span class="keywordtype">int</span> a2, <span class="keywordtype">int</span> a3 )
<a name="l00668"></a>00668 {
<a name="l00669"></a>00669   <span class="comment">// just store this address, since we're only going to do something with it in response to</span>
<a name="l00670"></a>00670   <span class="keywordflow">if</span>( !<a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>() )
<a name="l00671"></a>00671   {
<a name="l00672"></a>00672     Network_SetDefaults( );
<a name="l00673"></a>00673     <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00674"></a>00674   }
<a name="l00675"></a>00675   Network-&gt;TempMask = NETIF_IP_ADDRESS( a0, a1, a2, a3 );
<a name="l00676"></a>00676   <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00677"></a>00677 
<a name="l00678"></a>00678   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00679"></a>00679 }
<a name="l00680"></a>00680 <span class="comment"></span>
<a name="l00681"></a>00681 <span class="comment">/**</span>
<a name="l00682"></a>00682 <span class="comment">  Set the gateway address for the local network the Make Controller is on.</span>
<a name="l00683"></a>00683 <span class="comment">  The gateway address is commonly 192.168.0.1 for many home networks.</span>
<a name="l00684"></a>00684 <span class="comment">  Set the gateway address in dotted decimal form (xxx.xxx.xxx.xxx), passing in each </span>
<a name="l00685"></a>00685 <span class="comment">  number as a separate parameter.</span>
<a name="l00686"></a>00686 <span class="comment"></span>
<a name="l00687"></a>00687 <span class="comment">  This value is stored in EEPROM, so it persists even after the board</span>
<a name="l00688"></a>00688 <span class="comment">  is powered down.</span>
<a name="l00689"></a>00689 <span class="comment"></span>
<a name="l00690"></a>00690 <span class="comment">  @param a0 An integer corresponding to the first of 4 numbers in the gateway address.</span>
<a name="l00691"></a>00691 <span class="comment">  @param a1 An integer corresponding to the second of 4 numbers in the gateway address.</span>
<a name="l00692"></a>00692 <span class="comment">  @param a2 An integer corresponding to the third of 4 numbers in the gateway address.</span>
<a name="l00693"></a>00693 <span class="comment">  @param a3 An integer corresponding to the fourth of 4 numbers in the gateway address.</span>
<a name="l00694"></a>00694 <span class="comment">  @return 0 on success.</span>
<a name="l00695"></a>00695 <span class="comment"></span>
<a name="l00696"></a>00696 <span class="comment">  \par Example</span>
<a name="l00697"></a>00697 <span class="comment">  \code</span>
<a name="l00698"></a>00698 <span class="comment">  // set the gateway to 192.168.5.1</span>
<a name="l00699"></a>00699 <span class="comment">  if( 0 != Network_SetGateway( 192, 168, 5, 1 ) )</span>
<a name="l00700"></a>00700 <span class="comment">    // then there was a problem.</span>
<a name="l00701"></a>00701 <span class="comment">  \endcode</span>
<a name="l00702"></a>00702 <span class="comment">*/</span>
<a name="l00703"></a><a class="code" href="group___network.html#g1a5be7ffdac1a43d83f6c84369d0bb55">00703</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#g1a5be7ffdac1a43d83f6c84369d0bb55" title="Set the gateway address for the local network the Make Controller is on.">Network_SetGateway</a>( <span class="keywordtype">int</span> a0, <span class="keywordtype">int</span> a1, <span class="keywordtype">int</span> a2, <span class="keywordtype">int</span> a3 )
<a name="l00704"></a>00704 {
<a name="l00705"></a>00705   <span class="comment">// just store this address, since we're only going to do something with it in response to</span>
<a name="l00706"></a>00706   <span class="keywordflow">if</span>( !<a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>() )
<a name="l00707"></a>00707   {
<a name="l00708"></a>00708     Network_SetDefaults( );
<a name="l00709"></a>00709     <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00710"></a>00710   }
<a name="l00711"></a>00711   Network-&gt;TempGateway = NETIF_IP_ADDRESS( a0, a1, a2, a3 );
<a name="l00712"></a>00712   <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00713"></a>00713   
<a name="l00714"></a>00714   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00715"></a>00715 }
<a name="l00716"></a>00716 <span class="comment"></span>
<a name="l00717"></a>00717 <span class="comment">/**</span>
<a name="l00718"></a>00718 <span class="comment">  Read the board's current IP address.</span>
<a name="l00719"></a>00719 <span class="comment">  Pass in pointers to integers where the address should be stored.</span>
<a name="l00720"></a>00720 <span class="comment"></span>
<a name="l00721"></a>00721 <span class="comment">  @param a0 A pointer to an integer where the first of 4 numbers of the address is to be stored.</span>
<a name="l00722"></a>00722 <span class="comment">  @param a1 A pointer to an integer where the second of 4 numbers of the address is to be stored.</span>
<a name="l00723"></a>00723 <span class="comment">  @param a2 A pointer to an integer where the third of 4 numbers of the address is to be stored.</span>
<a name="l00724"></a>00724 <span class="comment">  @param a3 A pointer to an integer where the fourth of 4 numbers of the address is to be stored.</span>
<a name="l00725"></a>00725 <span class="comment">  @return 0 on success.</span>
<a name="l00726"></a>00726 <span class="comment">  </span>
<a name="l00727"></a>00727 <span class="comment">  \par Example</span>
<a name="l00728"></a>00728 <span class="comment">  \code</span>
<a name="l00729"></a>00729 <span class="comment">  int a0, a1, a2, a3;</span>
<a name="l00730"></a>00730 <span class="comment">  Network_GetAddress( &amp;a0, &amp;a1, &amp;a2, &amp;a3 );</span>
<a name="l00731"></a>00731 <span class="comment">  // now our variables are filled with the current address values</span>
<a name="l00732"></a>00732 <span class="comment">  \endcode</span>
<a name="l00733"></a>00733 <span class="comment">*/</span>
<a name="l00734"></a><a class="code" href="group___network.html#gf5c24462c4ca5bfcf8a9ffdb80c290d8">00734</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#gf5c24462c4ca5bfcf8a9ffdb80c290d8" title="Read the board&amp;#39;s current IP address.">Network_GetAddress</a>( <span class="keywordtype">int</span>* a0, <span class="keywordtype">int</span>* a1, <span class="keywordtype">int</span>* a2, <span class="keywordtype">int</span>* a3 )
<a name="l00735"></a>00735 {
<a name="l00736"></a>00736   <span class="keywordflow">if</span>( Network_GetPending() )
<a name="l00737"></a>00737     <span class="keywordflow">return</span> <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a>;
<a name="l00738"></a>00738 
<a name="l00739"></a>00739   <span class="keyword">struct </span>netif* mc_netif;
<a name="l00740"></a>00740   <span class="keywordtype">int</span> address = 0;
<a name="l00741"></a>00741   <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00742"></a>00742   mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00743"></a>00743   <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00744"></a>00744   {
<a name="l00745"></a>00745     address = mc_netif-&gt;ip_addr.addr;
<a name="l00746"></a>00746 
<a name="l00747"></a>00747     *a0 = NETIF_IP_ADDRESS_A( address );
<a name="l00748"></a>00748     *a1 = NETIF_IP_ADDRESS_B( address );
<a name="l00749"></a>00749     *a2 = NETIF_IP_ADDRESS_C( address );
<a name="l00750"></a>00750     *a3 = NETIF_IP_ADDRESS_D( address );
<a name="l00751"></a>00751   }
<a name="l00752"></a>00752   <span class="comment">// if the Ethernet interface is not up, we'll just get garbage back</span>
<a name="l00753"></a>00753   <span class="keywordflow">if</span>( *a0 &lt; 0 || *a0 &gt; 255 )
<a name="l00754"></a>00754     *a0 = *a1 = *a2 = *a3 = -1;
<a name="l00755"></a>00755 
<a name="l00756"></a>00756   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 <span class="comment"></span>
<a name="l00759"></a>00759 <span class="comment">/**</span>
<a name="l00760"></a>00760 <span class="comment">  Read the board's current network mask.</span>
<a name="l00761"></a>00761 <span class="comment">  Pass in pointers to integers where the mask should be stored.</span>
<a name="l00762"></a>00762 <span class="comment"></span>
<a name="l00763"></a>00763 <span class="comment">  @param a0 A pointer to an integer where the first of 4 numbers of the mask is to be stored.</span>
<a name="l00764"></a>00764 <span class="comment">  @param a1 A pointer to an integer where the second of 4 numbers of the mask is to be stored.</span>
<a name="l00765"></a>00765 <span class="comment">  @param a2 A pointer to an integer where the third of 4 numbers of the mask is to be stored.</span>
<a name="l00766"></a>00766 <span class="comment">  @param a3 A pointer to an integer where the fourth of 4 numbers of the mask is to be stored.</span>
<a name="l00767"></a>00767 <span class="comment">  @return 0 on success.</span>
<a name="l00768"></a>00768 <span class="comment">  </span>
<a name="l00769"></a>00769 <span class="comment">  \par Example</span>
<a name="l00770"></a>00770 <span class="comment">  \code</span>
<a name="l00771"></a>00771 <span class="comment">  int a0, a1, a2, a3;</span>
<a name="l00772"></a>00772 <span class="comment">  Network_GetMask( &amp;a0, &amp;a1, &amp;a2, &amp;a3 );</span>
<a name="l00773"></a>00773 <span class="comment">  // now our variables are filled with the current mask values</span>
<a name="l00774"></a>00774 <span class="comment">  \endcode</span>
<a name="l00775"></a>00775 <span class="comment">*/</span>
<a name="l00776"></a><a class="code" href="group___network.html#ga0837a01a5bd814cae2a080f8b2bf86b">00776</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#ga0837a01a5bd814cae2a080f8b2bf86b" title="Read the board&amp;#39;s current network mask.">Network_GetMask</a>( <span class="keywordtype">int</span>* a0, <span class="keywordtype">int</span>* a1, <span class="keywordtype">int</span>* a2, <span class="keywordtype">int</span>* a3 )
<a name="l00777"></a>00777 {
<a name="l00778"></a>00778   <span class="keywordflow">if</span>( Network_GetPending() )
<a name="l00779"></a>00779     <span class="keywordflow">return</span> <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a>;
<a name="l00780"></a>00780   
<a name="l00781"></a>00781   <span class="keyword">struct </span>netif* mc_netif;
<a name="l00782"></a>00782   <span class="keywordtype">int</span> address = 0;
<a name="l00783"></a>00783   <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00784"></a>00784   mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00785"></a>00785   <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00786"></a>00786   {
<a name="l00787"></a>00787     address = mc_netif-&gt;netmask.addr;
<a name="l00788"></a>00788 
<a name="l00789"></a>00789     *a0 = NETIF_IP_ADDRESS_A( address );
<a name="l00790"></a>00790     *a1 = NETIF_IP_ADDRESS_B( address );
<a name="l00791"></a>00791     *a2 = NETIF_IP_ADDRESS_C( address );
<a name="l00792"></a>00792     *a3 = NETIF_IP_ADDRESS_D( address );
<a name="l00793"></a>00793   }
<a name="l00794"></a>00794   <span class="keywordflow">if</span>( *a0 &lt; 0 || *a0 &gt; 255 )
<a name="l00795"></a>00795     *a0 = *a1 = *a2 = *a3 = -1;
<a name="l00796"></a>00796     
<a name="l00797"></a>00797   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00798"></a>00798 }
<a name="l00799"></a>00799 <span class="comment"></span>
<a name="l00800"></a>00800 <span class="comment">/**</span>
<a name="l00801"></a>00801 <span class="comment">  Read the board's current gateway address.</span>
<a name="l00802"></a>00802 <span class="comment">  Pass in pointers to integers where the gateway address should be stored.</span>
<a name="l00803"></a>00803 <span class="comment"></span>
<a name="l00804"></a>00804 <span class="comment">  @param a0 A pointer to an integer where the first of 4 numbers of the gateway address is to be stored.</span>
<a name="l00805"></a>00805 <span class="comment">  @param a1 A pointer to an integer where the second of 4 numbers of the gateway address is to be stored.</span>
<a name="l00806"></a>00806 <span class="comment">  @param a2 A pointer to an integer where the third of 4 numbers of the gateway address is to be stored.</span>
<a name="l00807"></a>00807 <span class="comment">  @param a3 A pointer to an integer where the fourth of 4 numbers of the gateway address is to be stored.</span>
<a name="l00808"></a>00808 <span class="comment">  @return 0 on success.</span>
<a name="l00809"></a>00809 <span class="comment">  </span>
<a name="l00810"></a>00810 <span class="comment">  \par Example</span>
<a name="l00811"></a>00811 <span class="comment">  \code</span>
<a name="l00812"></a>00812 <span class="comment">  int a0, a1, a2, a3;</span>
<a name="l00813"></a>00813 <span class="comment">  Network_GetGateway( &amp;a0, &amp;a1, &amp;a2, &amp;a3 );</span>
<a name="l00814"></a>00814 <span class="comment">  // now our variables are filled with the current gateway values</span>
<a name="l00815"></a>00815 <span class="comment">  \endcode</span>
<a name="l00816"></a>00816 <span class="comment">*/</span>
<a name="l00817"></a><a class="code" href="group___network.html#ge91ce5f124fcfbabc529d75fc222d49e">00817</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#ge91ce5f124fcfbabc529d75fc222d49e" title="Read the board&amp;#39;s current gateway address.">Network_GetGateway</a>( <span class="keywordtype">int</span>* a0, <span class="keywordtype">int</span>* a1, <span class="keywordtype">int</span>* a2, <span class="keywordtype">int</span>* a3 )
<a name="l00818"></a>00818 {
<a name="l00819"></a>00819   <span class="keywordflow">if</span>( Network_GetPending() )
<a name="l00820"></a>00820     <span class="keywordflow">return</span> <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a>;
<a name="l00821"></a>00821   
<a name="l00822"></a>00822   <span class="keyword">struct </span>netif* mc_netif;
<a name="l00823"></a>00823   <span class="keywordtype">int</span> address = 0;
<a name="l00824"></a>00824   <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00825"></a>00825   mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00826"></a>00826   <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00827"></a>00827   {
<a name="l00828"></a>00828     address = mc_netif-&gt;gw.addr;
<a name="l00829"></a>00829 
<a name="l00830"></a>00830     *a0 = NETIF_IP_ADDRESS_A( address );
<a name="l00831"></a>00831     *a1 = NETIF_IP_ADDRESS_B( address );
<a name="l00832"></a>00832     *a2 = NETIF_IP_ADDRESS_C( address );
<a name="l00833"></a>00833     *a3 = NETIF_IP_ADDRESS_D( address );
<a name="l00834"></a>00834   }
<a name="l00835"></a>00835   <span class="keywordflow">if</span>( *a0 &lt; 0 || *a0 &gt; 255 )
<a name="l00836"></a>00836     *a0 = *a1 = *a2 = *a3 = -1;
<a name="l00837"></a>00837   
<a name="l00838"></a>00838   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00839"></a>00839 }
<a name="l00840"></a>00840 <span class="comment"></span>
<a name="l00841"></a>00841 <span class="comment">/**</span>
<a name="l00842"></a>00842 <span class="comment">  Set whether DHCP is enabled.</span>
<a name="l00843"></a>00843 <span class="comment">  The Make Controller can use DHCP (Dynamic Host Configuration Protocol) to automatically</span>
<a name="l00844"></a>00844 <span class="comment">  retrieve an IP address from a router.  If you're using your Make Controller on a network</span>
<a name="l00845"></a>00845 <span class="comment">  with a router, it is generally preferred (and more convenient) to use DHCP.  Otherwise, turn</span>
<a name="l00846"></a>00846 <span class="comment">  DHCP off and set the IP address, mask, and gateway manually.</span>
<a name="l00847"></a>00847 <span class="comment">  </span>
<a name="l00848"></a>00848 <span class="comment">  Wikipedia has a good article about DHCP at http://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol</span>
<a name="l00849"></a>00849 <span class="comment">  </span>
<a name="l00850"></a>00850 <span class="comment">  This value is stored persistently, so it will remain constant across system reboots.</span>
<a name="l00851"></a>00851 <span class="comment">  @param enabled An integer specifying whether to enable DHCP - 1 (enable) or 0 (disable).</span>
<a name="l00852"></a>00852 <span class="comment">*/</span>
<a name="l00853"></a><a class="code" href="group___network.html#gc61ff10637ea2e5a44c4af330693e9e0">00853</a> <span class="keywordtype">void</span> <a class="code" href="group___network.html#gc61ff10637ea2e5a44c4af330693e9e0" title="Set whether DHCP is enabled.">Network_SetDhcpEnabled</a>( <span class="keywordtype">int</span> enabled )
<a name="l00854"></a>00854 {
<a name="l00855"></a>00855   <span class="keywordflow">if</span>( enabled &amp;&amp; !<a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>() )
<a name="l00856"></a>00856   {
<a name="l00857"></a>00857     <span class="keyword">struct </span>netif* mc_netif;
<a name="l00858"></a>00858     <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00859"></a>00859     mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00860"></a>00860     <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00861"></a>00861       Network_DhcpStart( mc_netif );
<a name="l00862"></a>00862       
<a name="l00863"></a>00863     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_DHCP_ENABLED, (uchar*)&amp;enabled, 4 );
<a name="l00864"></a>00864   }
<a name="l00865"></a>00865   
<a name="l00866"></a>00866   <span class="keywordflow">if</span>( !enabled &amp;&amp; <a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>() )
<a name="l00867"></a>00867   {
<a name="l00868"></a>00868     <span class="keyword">struct </span>netif* mc_netif;
<a name="l00869"></a>00869     <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00870"></a>00870     mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00871"></a>00871     <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00872"></a>00872       Network_DhcpStop( mc_netif );
<a name="l00873"></a>00873     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_DHCP_ENABLED, (uchar*)&amp;enabled, 4 );
<a name="l00874"></a>00874     <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l00875"></a>00875   }
<a name="l00876"></a>00876   <span class="keywordflow">return</span>;
<a name="l00877"></a>00877 }
<a name="l00878"></a>00878 <span class="comment"></span>
<a name="l00879"></a>00879 <span class="comment">/**</span>
<a name="l00880"></a>00880 <span class="comment">  Read whether DHCP is currently enabled.</span>
<a name="l00881"></a>00881 <span class="comment">  This value is stored presistently, so it will be the same across system reboots.</span>
<a name="l00882"></a>00882 <span class="comment">  @return An integer specifying whether DHCP is enabled - 1 (enabled) or 0 (disabled).</span>
<a name="l00883"></a>00883 <span class="comment">*/</span>
<a name="l00884"></a><a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60">00884</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>( )
<a name="l00885"></a>00885 {
<a name="l00886"></a>00886   <span class="keywordtype">int</span> state;
<a name="l00887"></a>00887   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_DHCP_ENABLED, (uchar*)&amp;state, 4 );
<a name="l00888"></a>00888   <span class="keywordflow">return</span> (state == 1) ? 1 : 0;
<a name="l00889"></a>00889 }
<a name="l00890"></a>00890 <span class="comment"></span>
<a name="l00891"></a>00891 <span class="comment">/**</span>
<a name="l00892"></a>00892 <span class="comment">  Set whether the demo webserver is enabled.</span>
<a name="l00893"></a>00893 <span class="comment">  The demo webserver provides access to some of the Make Controller's stats via a</span>
<a name="l00894"></a>00894 <span class="comment">  standard web browser.  It is intended mainly as a reference for creating web based applications.</span>
<a name="l00895"></a>00895 <span class="comment">  </span>
<a name="l00896"></a>00896 <span class="comment">  This value is stored persistently, so it will remain constant across system reboots.</span>
<a name="l00897"></a>00897 <span class="comment">  @param state An integer specifying whether to enable the webserver - 1 (enable) or 0 (disable).</span>
<a name="l00898"></a>00898 <span class="comment">*/</span>
<a name="l00899"></a><a class="code" href="group___network.html#g8e37b3166ad4cafc5261e3de373e9261">00899</a> <span class="keywordtype">void</span> <a class="code" href="group___network.html#g8e37b3166ad4cafc5261e3de373e9261" title="Set whether the demo webserver is enabled.">Network_SetWebServerEnabled</a>( <span class="keywordtype">int</span> state )
<a name="l00900"></a>00900 {
<a name="l00901"></a>00901   <span class="keywordflow">if</span>( state )
<a name="l00902"></a>00902   {
<a name="l00903"></a>00903     Network_StartWebServer( );
<a name="l00904"></a>00904 
<a name="l00905"></a>00905     <span class="keywordflow">if</span>( !<a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace" title="Read whether the demo webserver is enabled.">Network_GetWebServerEnabled</a>( ) )
<a name="l00906"></a>00906       <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_WEBSERVER_ENABLED, (uchar*)&amp;state, 4 );
<a name="l00907"></a>00907   }
<a name="l00908"></a>00908   <span class="keywordflow">else</span>
<a name="l00909"></a>00909   {
<a name="l00910"></a>00910     Network_StopWebServer( );
<a name="l00911"></a>00911 
<a name="l00912"></a>00912     <span class="keywordflow">if</span>( <a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace" title="Read whether the demo webserver is enabled.">Network_GetWebServerEnabled</a>( ) )
<a name="l00913"></a>00913       <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_WEBSERVER_ENABLED, (uchar*)&amp;state, 4 );
<a name="l00914"></a>00914   }
<a name="l00915"></a>00915 }
<a name="l00916"></a>00916 <span class="comment"></span>
<a name="l00917"></a>00917 <span class="comment">/**</span>
<a name="l00918"></a>00918 <span class="comment">  Read whether the demo webserver is enabled.</span>
<a name="l00919"></a>00919 <span class="comment">  This value is stored presistently, so it will be the same across system reboots.</span>
<a name="l00920"></a>00920 <span class="comment">  @return An integer specifying whether the webserver is enabled - 1 (enabled) or 0 (disabled).</span>
<a name="l00921"></a>00921 <span class="comment">*/</span>
<a name="l00922"></a><a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace">00922</a> <span class="keywordtype">int</span> <a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace" title="Read whether the demo webserver is enabled.">Network_GetWebServerEnabled</a>( )
<a name="l00923"></a>00923 {
<a name="l00924"></a>00924   <span class="keywordtype">int</span> state;
<a name="l00925"></a>00925   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_WEBSERVER_ENABLED, (uchar*)&amp;state, 4 );
<a name="l00926"></a>00926   <span class="keywordflow">return</span> (state == 1) ? 1 : 0;
<a name="l00927"></a>00927 }
<a name="l00928"></a>00928 <span class="comment"></span>
<a name="l00929"></a>00929 <span class="comment">/** @}</span>
<a name="l00930"></a>00930 <span class="comment">*/</span>
<a name="l00931"></a>00931 <span class="comment"></span>
<a name="l00932"></a>00932 <span class="comment">/**</span>
<a name="l00933"></a>00933 <span class="comment">  Create a checksum for the current address settings and store it in EEPROM.</span>
<a name="l00934"></a>00934 <span class="comment">  This should be called each time an address setting is changed so that if</span>
<a name="l00935"></a>00935 <span class="comment">  the board gets powered down, it will know when it comes back up whether or</span>
<a name="l00936"></a>00936 <span class="comment">  not the address settings is currently has are valid.</span>
<a name="l00937"></a>00937 <span class="comment"></span>
<a name="l00938"></a>00938 <span class="comment">  @param v An integer specifying whether to validate the current settings (1)</span>
<a name="l00939"></a>00939 <span class="comment">  or to force them to be invalidated (0).</span>
<a name="l00940"></a>00940 <span class="comment">  Passing in 0 returns the address settings to their factory defaults.</span>
<a name="l00941"></a>00941 <span class="comment">  @return 0 on success.</span>
<a name="l00942"></a>00942 <span class="comment">*/</span>
<a name="l00943"></a><a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246">00943</a> <span class="keywordtype">int</span> <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( <span class="keywordtype">int</span> v )
<a name="l00944"></a>00944 {
<a name="l00945"></a>00945   <span class="keywordflow">if</span> ( v )
<a name="l00946"></a>00946   {
<a name="l00947"></a>00947     <span class="keyword">struct </span>ip_addr ip, gw, mask;
<a name="l00948"></a>00948     <span class="keyword">struct </span>netif* mc_netif;
<a name="l00949"></a>00949 
<a name="l00950"></a>00950     ip.addr = Network-&gt;TempIpAddress; <span class="comment">// these should each have been set previously</span>
<a name="l00951"></a>00951     mask.addr = Network-&gt;TempMask;  <span class="comment">// by Network_SetAddress(), etc.</span>
<a name="l00952"></a>00952     gw.addr = Network-&gt;TempGateway;
<a name="l00953"></a>00953     <span class="keywordflow">if</span>( !<a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>() ) <span class="comment">// only actually change the address if we're not using DHCP</span>
<a name="l00954"></a>00954     {
<a name="l00955"></a>00955       <span class="comment">// we specify our network interface as en0 when we init</span>
<a name="l00956"></a>00956       mc_netif = netif_find( <span class="stringliteral">"en0"</span> );
<a name="l00957"></a>00957       <span class="keywordflow">if</span>( mc_netif != NULL )
<a name="l00958"></a>00958         netif_set_addr( mc_netif, &amp;ip, &amp;mask, &amp;gw );
<a name="l00959"></a>00959     }
<a name="l00960"></a>00960     
<a name="l00961"></a>00961     <span class="comment">// but write the addresses to memory regardless, so we can use them next time we boot up without DHCP</span>
<a name="l00962"></a>00962     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_SYSTEM_NET_ADDRESS, (uchar*)&amp;ip.addr, 4 );
<a name="l00963"></a>00963     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_SYSTEM_NET_MASK, (uchar*)&amp;mask.addr, 4 );
<a name="l00964"></a>00964     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_SYSTEM_NET_GATEWAY, (uchar*)&amp;gw.addr, 4 );
<a name="l00965"></a>00965 
<a name="l00966"></a>00966     <span class="keywordtype">int</span> total = Network-&gt;TempIpAddress + Network-&gt;TempMask + Network-&gt;TempGateway;
<a name="l00967"></a>00967     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_SYSTEM_NET_CHECK, (uchar*)&amp;total, 4 );
<a name="l00968"></a>00968 
<a name="l00969"></a>00969     Network_Valid = NET_VALID;
<a name="l00970"></a>00970   }
<a name="l00971"></a>00971   <span class="keywordflow">else</span>
<a name="l00972"></a>00972   {
<a name="l00973"></a>00973     <span class="keywordtype">int</span> value = 0;
<a name="l00974"></a>00974     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_SYSTEM_NET_CHECK, (uchar*)&amp;value, 4 );
<a name="l00975"></a>00975     Network_Valid = NET_INVALID;
<a name="l00976"></a>00976   }
<a name="l00977"></a>00977 
<a name="l00978"></a>00978   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l00979"></a>00979 }
<a name="l00980"></a>00980 <span class="comment"></span>
<a name="l00981"></a>00981 <span class="comment">/**</span>
<a name="l00982"></a>00982 <span class="comment">  Read the checksum for address settings in EEPROM, and determine if it matches </span>
<a name="l00983"></a>00983 <span class="comment">  the current settings.</span>
<a name="l00984"></a>00984 <span class="comment"></span>
<a name="l00985"></a>00985 <span class="comment">  @return An integer specifying the validity of the settings - 1 (valid) or 0 (invalid).</span>
<a name="l00986"></a>00986 <span class="comment">*/</span>
<a name="l00987"></a><a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528">00987</a> <span class="keywordtype">int</span> <a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>( )
<a name="l00988"></a>00988 {
<a name="l00989"></a>00989   <span class="keywordtype">int</span> address, mask, gateway, total;
<a name="l00990"></a>00990   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_ADDRESS, (uchar*)&amp;address, 4 );
<a name="l00991"></a>00991   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_MASK, (uchar*)&amp;mask, 4 );
<a name="l00992"></a>00992   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_GATEWAY, (uchar*)&amp;gateway, 4 );
<a name="l00993"></a>00993   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_SYSTEM_NET_CHECK, (uchar*)&amp;total, 4 );
<a name="l00994"></a>00994 
<a name="l00995"></a>00995   <span class="keywordflow">if</span> ( total == address + mask + gateway )
<a name="l00996"></a>00996   {
<a name="l00997"></a>00997     Network_Valid = NET_VALID;
<a name="l00998"></a>00998     <span class="keywordflow">return</span> 1;
<a name="l00999"></a>00999   }
<a name="l01000"></a>01000   <span class="keywordflow">else</span>
<a name="l01001"></a>01001   {
<a name="l01002"></a>01002     Network_Valid = NET_INVALID;
<a name="l01003"></a>01003     <span class="keywordflow">return</span> 0;
<a name="l01004"></a>01004   }
<a name="l01005"></a>01005 }
<a name="l01006"></a>01006 
<a name="l01007"></a>01007 <span class="comment">// if things aren't valid, just set the defaults</span>
<a name="l01008"></a>01008 <span class="keywordtype">void</span> Network_SetDefaults( )
<a name="l01009"></a>01009 {
<a name="l01010"></a>01010   Network-&gt;TempIpAddress = NETIF_IP_ADDRESS( 192, 168, 0, 200 );
<a name="l01011"></a>01011   Network-&gt;TempGateway = NETIF_IP_ADDRESS( 192, 168, 0, 1 );
<a name="l01012"></a>01012   Network-&gt;TempMask = NETIF_IP_ADDRESS( 255, 255, 255, 0 );
<a name="l01013"></a>01013   <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( 1 );
<a name="l01014"></a>01014 }
<a name="l01015"></a>01015 <span class="comment"></span>
<a name="l01016"></a>01016 <span class="comment">/**</span>
<a name="l01017"></a>01017 <span class="comment">  Sets whether the Network subsystem is currently trying to negotiate its settings.</span>
<a name="l01018"></a>01018 <span class="comment">  This is mostly used by the Network init and deinit processes, so you shouldn't</span>
<a name="l01019"></a>01019 <span class="comment">  be calling this yourself unless you have a good reason to.</span>
<a name="l01020"></a>01020 <span class="comment">  @param state An integer specifying the pending state - 1 (pending) or 0 (not pending).</span>
<a name="l01021"></a>01021 <span class="comment">*/</span>
<a name="l01022"></a><a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d">01022</a> <span class="keywordtype">void</span> <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( <span class="keywordtype">int</span> state )
<a name="l01023"></a>01023 {
<a name="l01024"></a>01024   <span class="keywordflow">if</span>( state &amp;&amp; !Network-&gt;pending )
<a name="l01025"></a>01025       Network-&gt;pending = state;
<a name="l01026"></a>01026   <span class="keywordflow">if</span>( !state &amp;&amp; Network-&gt;pending )
<a name="l01027"></a>01027     Network-&gt;pending = state;
<a name="l01028"></a>01028 }
<a name="l01029"></a>01029 
<a name="l01030"></a>01030 <span class="keywordtype">int</span> Network_GetPending( )
<a name="l01031"></a>01031 {
<a name="l01032"></a>01032   <span class="keywordflow">return</span> Network-&gt;pending;
<a name="l01033"></a>01033 }
<a name="l01034"></a>01034 
<a name="l01035"></a>01035 <span class="keywordtype">void</span> NetworkOsc_SetTcpOutAddress( <span class="keywordtype">int</span> a0, <span class="keywordtype">int</span> a1, <span class="keywordtype">int</span> a2, <span class="keywordtype">int</span> a3 )
<a name="l01036"></a>01036 {
<a name="l01037"></a>01037   <span class="keywordtype">int</span> address = IP_ADDRESS( a0, a1, a2, a3 );
<a name="l01038"></a>01038   <span class="keywordflow">if</span>( address != Network-&gt;TcpOutAddress )
<a name="l01039"></a>01039   {
<a name="l01040"></a>01040     Network-&gt;TcpOutAddress = address;
<a name="l01041"></a>01041     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_TCP_OUT_ADDRESS, (uchar*)&amp;address, 4 );
<a name="l01042"></a>01042   }
<a name="l01043"></a>01043 }
<a name="l01044"></a>01044 
<a name="l01045"></a>01045 <span class="keywordtype">int</span> NetworkOsc_GetTcpOutAddress( )
<a name="l01046"></a>01046 {
<a name="l01047"></a>01047   <span class="keywordflow">return</span> Network-&gt;TcpOutAddress;
<a name="l01048"></a>01048 }
<a name="l01049"></a>01049 
<a name="l01050"></a>01050 <span class="keywordtype">void</span> NetworkOsc_SetTcpOutPort( <span class="keywordtype">int</span> port )
<a name="l01051"></a>01051 {
<a name="l01052"></a>01052   <span class="keywordflow">if</span>( port != Network-&gt;TcpOutPort ) <span class="comment">// only change if it's a new value</span>
<a name="l01053"></a>01053   {
<a name="l01054"></a>01054     Network-&gt;TcpOutPort = port;
<a name="l01055"></a>01055     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_TCP_OUT_PORT, (uchar*)&amp;port, 4 );
<a name="l01056"></a>01056   }
<a name="l01057"></a>01057 }
<a name="l01058"></a>01058 
<a name="l01059"></a>01059 <span class="keywordtype">int</span> NetworkOsc_GetTcpOutPort( )
<a name="l01060"></a>01060 {
<a name="l01061"></a>01061   <span class="keywordflow">return</span> Network-&gt;TcpOutPort;
<a name="l01062"></a>01062 }
<a name="l01063"></a>01063 
<a name="l01064"></a>01064 <span class="keywordtype">void</span> NetworkOsc_SetUdpListenPort( <span class="keywordtype">int</span> port )
<a name="l01065"></a>01065 {
<a name="l01066"></a>01066   <span class="keywordflow">if</span>( port != Network-&gt;OscUdpListenPort ) <span class="comment">// only change things if it's a new value</span>
<a name="l01067"></a>01067   {
<a name="l01068"></a>01068     Network-&gt;OscUdpListenPort = port;
<a name="l01069"></a>01069     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_OSC_UDP_LISTEN_PORT, (uchar*)&amp;port, 4 );
<a name="l01070"></a>01070   }
<a name="l01071"></a>01071 }
<a name="l01072"></a>01072 
<a name="l01073"></a>01073 <span class="keywordtype">int</span> NetworkOsc_GetUdpListenPort(  )
<a name="l01074"></a>01074 {
<a name="l01075"></a>01075   <span class="keywordtype">int</span> port;
<a name="l01076"></a>01076   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_OSC_UDP_LISTEN_PORT, (uchar*)&amp;port, 4 );
<a name="l01077"></a>01077   
<a name="l01078"></a>01078   <span class="keywordflow">if</span>( port &gt; 0 &amp;&amp; port &lt; 65536 )
<a name="l01079"></a>01079     <span class="keywordflow">return</span> port;
<a name="l01080"></a>01080   <span class="keywordflow">else</span>
<a name="l01081"></a>01081     <span class="keywordflow">return</span> 10000;
<a name="l01082"></a>01082 }
<a name="l01083"></a>01083 
<a name="l01084"></a>01084 <span class="keywordtype">void</span> NetworkOsc_SetUdpSendPort( <span class="keywordtype">int</span> port )
<a name="l01085"></a>01085 {
<a name="l01086"></a>01086   <span class="keywordflow">if</span>( port != Network-&gt;OscUdpSendPort ) <span class="comment">// only change things if it's a new value</span>
<a name="l01087"></a>01087   {
<a name="l01088"></a>01088     Network-&gt;OscUdpSendPort = port;
<a name="l01089"></a>01089     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_OSC_UDP_SEND_PORT, (uchar*)&amp;port, 4 );
<a name="l01090"></a>01090   }
<a name="l01091"></a>01091 }
<a name="l01092"></a>01092 
<a name="l01093"></a>01093 <span class="keywordtype">int</span> NetworkOsc_GetUdpSendPort(  )
<a name="l01094"></a>01094 {
<a name="l01095"></a>01095   <span class="keywordtype">int</span> port;
<a name="l01096"></a>01096   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_OSC_UDP_SEND_PORT, (uchar*)&amp;port, 4 );
<a name="l01097"></a>01097   
<a name="l01098"></a>01098   <span class="keywordflow">if</span>( port &gt; 0 &amp;&amp; port &lt; 65536 )
<a name="l01099"></a>01099     <span class="keywordflow">return</span> port;
<a name="l01100"></a>01100   <span class="keywordflow">else</span>
<a name="l01101"></a>01101     <span class="keywordflow">return</span> 10000;
<a name="l01102"></a>01102 }
<a name="l01103"></a>01103 
<a name="l01104"></a>01104 <span class="keywordtype">void</span> Network_StartWebServer( )
<a name="l01105"></a>01105 {
<a name="l01106"></a>01106   <a class="code" href="group__webserver.html#g5a95d049647db95b76a70bc5f722719c" title="Set the active state of the WebServer subsystem.">WebServer_SetActive</a>( 1 );
<a name="l01107"></a>01107 }
<a name="l01108"></a>01108 
<a name="l01109"></a>01109 <span class="keywordtype">void</span> Network_StopWebServer( )
<a name="l01110"></a>01110 {
<a name="l01111"></a>01111   <a class="code" href="group__webserver.html#g5a95d049647db95b76a70bc5f722719c" title="Set the active state of the WebServer subsystem.">WebServer_SetActive</a>( 0 );
<a name="l01112"></a>01112 }
<a name="l01113"></a>01113 
<a name="l01114"></a>01114 <span class="keywordtype">void</span> Network_DhcpStart( <span class="keyword">struct</span> netif* netif )
<a name="l01115"></a>01115 {
<a name="l01116"></a>01116   <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( 1 ); <span class="comment">// set a flag so nobody else tries to set up this netif</span>
<a name="l01117"></a>01117   <span class="keywordtype">int</span> count = 0;
<a name="l01118"></a>01118   dhcp_start( netif );
<a name="l01119"></a>01119   <span class="comment">// now hang out for a second until we get an address</span>
<a name="l01120"></a>01120   <span class="comment">// if DHCP is enabled but we don't find a DHCP server, just use the network config stored in EEPROM</span>
<a name="l01121"></a>01121   <span class="keywordflow">while</span>( netif-&gt;ip_addr.addr == 0 &amp;&amp; count &lt; 100 ) <span class="comment">// timeout after 10 (?) seconds of waiting for a DHCP address</span>
<a name="l01122"></a>01122   {
<a name="l01123"></a>01123     count++;
<a name="l01124"></a>01124     <a class="code" href="group___tasks.html#g9a64a7c0e24f257826103d1d1bbb44fa" title="Put a task to sleep for a given number of milliseconds.">Sleep</a>( 100 );
<a name="l01125"></a>01125   }
<a name="l01126"></a>01126   <span class="keywordflow">if</span>( netif-&gt;ip_addr.addr == 0 ) <span class="comment">// if we timed out getting an address via DHCP, just use whatever's in EEPROM</span>
<a name="l01127"></a>01127   {
<a name="l01128"></a>01128     <span class="keyword">struct </span>ip_addr ip, gw, mask; <span class="comment">// network config stored in EEPROM</span>
<a name="l01129"></a>01129     ip.addr = Network-&gt;TempIpAddress;
<a name="l01130"></a>01130     mask.addr = Network-&gt;TempMask;
<a name="l01131"></a>01131     gw.addr = Network-&gt;TempGateway;
<a name="l01132"></a>01132     netif_set_addr( netif, &amp;ip, &amp;mask, &amp;gw );
<a name="l01133"></a>01133   }
<a name="l01134"></a>01134   sys_timeout( DHCP_FINE_TIMER_MSECS, dhcp_fine_tmr, NULL );
<a name="l01135"></a>01135   sys_timeout( DHCP_COARSE_TIMER_SECS * 1000, dhcp_coarse_tmr, NULL );
<a name="l01136"></a>01136   <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( 0 );
<a name="l01137"></a>01137   <span class="keywordflow">return</span>;
<a name="l01138"></a>01138 }
<a name="l01139"></a>01139 
<a name="l01140"></a>01140 <span class="keywordtype">void</span> Network_DhcpStop( <span class="keyword">struct</span> netif* netif )
<a name="l01141"></a>01141 {
<a name="l01142"></a>01142   dhcp_release( netif );
<a name="l01143"></a>01143   sys_untimeout( dhcp_fine_tmr, NULL );
<a name="l01144"></a>01144   sys_untimeout( dhcp_coarse_tmr, NULL );
<a name="l01145"></a>01145   netif_set_up(netif); <span class="comment">// bring the interface back up, as dhcp_release() takes it down</span>
<a name="l01146"></a>01146   <span class="keywordflow">return</span>;
<a name="l01147"></a>01147 }
<a name="l01148"></a>01148 
<a name="l01149"></a>01149 
<a name="l01150"></a>01150 <span class="keywordtype">int</span> Network_AddressConvert( <span class="keywordtype">char</span>* address, <span class="keywordtype">int</span>* a0, <span class="keywordtype">int</span>* a1, <span class="keywordtype">int</span>* a2, <span class="keywordtype">int</span>* a3 )
<a name="l01151"></a>01151 {
<a name="l01152"></a>01152   <span class="keywordflow">return</span> ( sscanf( address, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 ) == 4 ) ? <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> : <a class="code" href="group___error.html#gf0c0d854039c8ccbb5fed2a35ded843b" title="Board doesn&amp;#39;t have an address.">CONTROLLER_ERROR_NO_ADDRESS</a>;
<a name="l01153"></a>01153 }
<a name="l01154"></a>01154 
<a name="l01155"></a>01155 <span class="preprocessor">#if ( CONTROLLER_VERSION == 50 || CONTROLLER_VERSION == 95 || CONTROLLER_VERSION == 100 )</span>
<a name="l01156"></a>01156 <span class="preprocessor"></span><span class="preprocessor">#define NETWORK_BITS IO_PB00_BIT | IO_PB01_BIT | IO_PB02_BIT | IO_PB03_BIT | IO_PB04_BIT | \</span>
<a name="l01157"></a>01157 <span class="preprocessor">                     IO_PB05_BIT | IO_PB06_BIT | IO_PB07_BIT | IO_PB08_BIT | IO_PB09_BIT | \</span>
<a name="l01158"></a>01158 <span class="preprocessor">                     IO_PB10_BIT | IO_PB11_BIT | IO_PB12_BIT | IO_PB13_BIT | IO_PB14_BIT | \</span>
<a name="l01159"></a>01159 <span class="preprocessor">                     IO_PB15_BIT | IO_PB16_BIT | IO_PB17_BIT | IO_PB18_BIT | IO_PB26_BIT</span>
<a name="l01160"></a>01160 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l01161"></a>01161 <span class="preprocessor"></span><span class="preprocessor">#if ( CONTROLLER_VERSION == 90 )</span>
<a name="l01162"></a>01162 <span class="preprocessor"></span><span class="preprocessor">#define NETWORK_BITS IO_PB00_BIT | IO_PB01_BIT | IO_PB02_BIT | IO_PB03_BIT | IO_PB04_BIT | \</span>
<a name="l01163"></a>01163 <span class="preprocessor">                     IO_PB05_BIT | IO_PB06_BIT | IO_PB07_BIT | IO_PB08_BIT | IO_PB09_BIT | \</span>
<a name="l01164"></a>01164 <span class="preprocessor">                     IO_PB15_BIT | IO_PB26_BIT</span>
<a name="l01165"></a>01165 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l01166"></a>01166 <span class="preprocessor"></span>
<a name="l01167"></a>01167 <span class="keywordtype">int</span> Network_Init( )
<a name="l01168"></a>01168 {
<a name="l01169"></a>01169   <span class="comment">// Start and Lock all the bits to do with the Ethernet Phy - can do this immediately, since there's no undoing this</span>
<a name="l01170"></a>01170   <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( 1 );
<a name="l01171"></a>01171   Io_StartBits( NETWORK_BITS, <span class="keyword">true</span> );
<a name="l01172"></a>01172 
<a name="l01173"></a>01173   <span class="comment">// Attempt to get a serial number and set it into the mac address low bytes to make a unique MAC address</span>
<a name="l01174"></a>01174   <span class="keywordtype">int</span> serialNumber = <a class="code" href="group___system.html#g42dad93cdc36c55a34f225982a0ff753" title="Gets the board&amp;#39;s Serial Number.">System_GetSerialNumber</a>();
<a name="l01175"></a>01175   emacETHADDR5 = serialNumber &amp; 0xFF;
<a name="l01176"></a>01176   emacETHADDR4 = ( serialNumber &gt;&gt; 8 ) &amp; 0xFF;
<a name="l01177"></a>01177   <span class="comment">// Low nibble of the third byte - gives us around 1M serial numbers</span>
<a name="l01178"></a>01178   emacETHADDR3 = 0x50 | ( ( serialNumber &gt;&gt; 12 ) &amp; 0xF );
<a name="l01179"></a>01179 
<a name="l01180"></a>01180   <span class="comment">/* Initialize lwIP and its interface layer. */</span>
<a name="l01181"></a>01181   stats_init();
<a name="l01182"></a>01182   sys_init();
<a name="l01183"></a>01183   mem_init();               
<a name="l01184"></a>01184   memp_init();
<a name="l01185"></a>01185   pbuf_init(); 
<a name="l01186"></a>01186   netif_init();
<a name="l01187"></a>01187   ip_init();
<a name="l01188"></a>01188   tcpip_init( NULL, NULL );
<a name="l01189"></a>01189 
<a name="l01190"></a>01190   <span class="keyword">extern</span> err_t ethernetif_init( <span class="keyword">struct</span> netif *netif );
<a name="l01191"></a>01191   <span class="keyword">static</span> <span class="keyword">struct </span>netif EMAC_if;
<a name="l01192"></a>01192   <span class="keywordtype">int</span> address, mask, gateway, dhcp;
<a name="l01193"></a>01193   dhcp = <a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>();
<a name="l01194"></a>01194 
<a name="l01195"></a>01195   <span class="keywordflow">if</span>( dhcp )
<a name="l01196"></a>01196   {
<a name="l01197"></a>01197     address = 0;
<a name="l01198"></a>01198     mask = 0;
<a name="l01199"></a>01199     gateway = 0;
<a name="l01200"></a>01200   }
<a name="l01201"></a>01201   <span class="keywordflow">else</span> <span class="comment">// DHCP not enabled, just read whatever the manual IP address in EEPROM is.</span>
<a name="l01202"></a>01202   {
<a name="l01203"></a>01203     address = Network-&gt;TempIpAddress;
<a name="l01204"></a>01204     mask = Network-&gt;TempMask;
<a name="l01205"></a>01205     gateway = Network-&gt;TempGateway;
<a name="l01206"></a>01206   }
<a name="l01207"></a>01207   <span class="comment">// add our network interface to the system</span>
<a name="l01208"></a>01208   <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( 1 ); <span class="comment">//netif_add goes away for a long time if there's no Ethernet cable connected.</span>
<a name="l01209"></a>01209   netif_add(&amp;EMAC_if, (<span class="keyword">struct</span> ip_addr*)&amp;address, (<span class="keyword">struct</span> ip_addr*)&amp;mask, 
<a name="l01210"></a>01210                         (<span class="keyword">struct</span> ip_addr*)&amp;gateway, NULL, ethernetif_init, tcpip_input);
<a name="l01211"></a>01211   <span class="comment">// make it the default interface</span>
<a name="l01212"></a>01212   netif_set_default(&amp;EMAC_if);
<a name="l01213"></a>01213   <span class="comment">// bring it up</span>
<a name="l01214"></a>01214   netif_set_up(&amp;EMAC_if);
<a name="l01215"></a>01215   <span class="comment">// name it so we can find it later</span>
<a name="l01216"></a>01216   EMAC_if.name[0] = <span class="charliteral">'e'</span>;
<a name="l01217"></a>01217   EMAC_if.name[1] = <span class="charliteral">'n'</span>;
<a name="l01218"></a>01218   EMAC_if.num = 0;
<a name="l01219"></a>01219   
<a name="l01220"></a>01220 <span class="preprocessor">  #ifdef OSC</span>
<a name="l01221"></a>01221 <span class="preprocessor"></span>  <span class="keywordflow">if</span>( NetworkOsc_GetTcpAutoConnect( ) )
<a name="l01222"></a>01222   {
<a name="l01223"></a>01223     Network-&gt;TcpRequested = 1;
<a name="l01224"></a>01224     Osc_StartTcpTask( );
<a name="l01225"></a>01225   }
<a name="l01226"></a>01226 <span class="preprocessor">  #endif</span>
<a name="l01227"></a>01227 <span class="preprocessor"></span>
<a name="l01228"></a>01228   <span class="keywordflow">if</span>( <a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace" title="Read whether the demo webserver is enabled.">Network_GetWebServerEnabled</a>( ) )
<a name="l01229"></a>01229     Network_StartWebServer( );
<a name="l01230"></a>01230   
<a name="l01231"></a>01231   <span class="keywordflow">if</span>( dhcp )
<a name="l01232"></a>01232     Network_DhcpStart( &amp;EMAC_if );
<a name="l01233"></a>01233 
<a name="l01234"></a>01234   <a class="code" href="network_8c.html#35fd15dc15186da23f53198c1100ec2d" title="Sets whether the Network subsystem is currently trying to negotiate its settings...">Network_SetPending</a>( 0 );
<a name="l01235"></a>01235   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l01236"></a>01236 }
<a name="l01237"></a>01237 <span class="comment"></span>
<a name="l01238"></a>01238 <span class="comment">/** \defgroup NetworkOSC Network - OSC</span>
<a name="l01239"></a>01239 <span class="comment">  Configure the Controller Board's Network Settings via OSC.</span>
<a name="l01240"></a>01240 <span class="comment">  \ingroup OSC</span>
<a name="l01241"></a>01241 <span class="comment">   </span>
<a name="l01242"></a>01242 <span class="comment">    \section devices Devices</span>
<a name="l01243"></a>01243 <span class="comment">    There is only one Network system, so a device index is not used.</span>
<a name="l01244"></a>01244 <span class="comment">   </span>
<a name="l01245"></a>01245 <span class="comment">    \section properties Properties</span>
<a name="l01246"></a>01246 <span class="comment">    The Network system has seven properties </span>
<a name="l01247"></a>01247 <span class="comment">    - address</span>
<a name="l01248"></a>01248 <span class="comment">    - mask</span>
<a name="l01249"></a>01249 <span class="comment">    - gateway</span>
<a name="l01250"></a>01250 <span class="comment">    - valid</span>
<a name="l01251"></a>01251 <span class="comment">    - mac</span>
<a name="l01252"></a>01252 <span class="comment">    - osc_udp_port</span>
<a name="l01253"></a>01253 <span class="comment">    - dhcp</span>
<a name="l01254"></a>01254 <span class="comment">    - webserver</span>
<a name="l01255"></a>01255 <span class="comment"></span>
<a name="l01256"></a>01256 <span class="comment">    \par Address</span>
<a name="l01257"></a>01257 <span class="comment">    The \b address property corresponds to the IP address of the Controller Board.</span>
<a name="l01258"></a>01258 <span class="comment">    This value can be both read and written.  To set a new address, send a message like</span>
<a name="l01259"></a>01259 <span class="comment">    \verbatim /network/address 192.168.0.235 \endverbatim</span>
<a name="l01260"></a>01260 <span class="comment">    \par</span>
<a name="l01261"></a>01261 <span class="comment">    To read the current IP address, omit the argument value from the end of the message:</span>
<a name="l01262"></a>01262 <span class="comment">    \verbatim /network/address \endverbatim</span>
<a name="l01263"></a>01263 <span class="comment">   </span>
<a name="l01264"></a>01264 <span class="comment">    \par Mask</span>
<a name="l01265"></a>01265 <span class="comment">    The \b mask property corresponds to the network mask of the Controller Board.</span>
<a name="l01266"></a>01266 <span class="comment">    When on a subnet or local network, the network mask must be set in order</span>
<a name="l01267"></a>01267 <span class="comment">    for the gateway to route information to the board's IP address properly.</span>
<a name="l01268"></a>01268 <span class="comment">    The mask is commonly 255.255.255.0 for many home networks.</span>
<a name="l01269"></a>01269 <span class="comment">    \par</span>
<a name="l01270"></a>01270 <span class="comment">    To set the board's network mask, send a message like</span>
<a name="l01271"></a>01271 <span class="comment">    \verbatim /network/mask 255.255.255.0 \endverbatim</span>
<a name="l01272"></a>01272 <span class="comment">    To read the current mask, omit the argument value from the end of the message:</span>
<a name="l01273"></a>01273 <span class="comment">    \verbatim /network/mask \endverbatim</span>
<a name="l01274"></a>01274 <span class="comment">   </span>
<a name="l01275"></a>01275 <span class="comment">    \par Gateway</span>
<a name="l01276"></a>01276 <span class="comment">    The \b gateway property corresponds to the gateway address for the local network the Make Controller is on.</span>
<a name="l01277"></a>01277 <span class="comment">    The gateway address is the address</span>
<a name="l01278"></a>01278 <span class="comment">    The gateway address is commonly the address of the router on many home networks, and its</span>
<a name="l01279"></a>01279 <span class="comment">    value is commonly 192.168.0.1.\n</span>
<a name="l01280"></a>01280 <span class="comment">    This value is stored in EEPROM, so it persists even after the board</span>
<a name="l01281"></a>01281 <span class="comment">    is powered down.</span>
<a name="l01282"></a>01282 <span class="comment">    \par</span>
<a name="l01283"></a>01283 <span class="comment">    To set the board's gateway address, send a message like</span>
<a name="l01284"></a>01284 <span class="comment">    \verbatim /network/gateway 192.168.0.1 \endverbatim</span>
<a name="l01285"></a>01285 <span class="comment">    To read the current gateway, omit the argument value from the end of the message:</span>
<a name="l01286"></a>01286 <span class="comment">    \verbatim /network/gateway \endverbatim</span>
<a name="l01287"></a>01287 <span class="comment"></span>
<a name="l01288"></a>01288 <span class="comment">    \par Valid</span>
<a name="l01289"></a>01289 <span class="comment">    The \b valid property is used to make sure the board's network settings are valid.</span>
<a name="l01290"></a>01290 <span class="comment">    If you're manually setting the \b address, \b gateway, or \b mask settings, you'll need</span>
<a name="l01291"></a>01291 <span class="comment">    to send the valid message for them to take effect.</span>
<a name="l01292"></a>01292 <span class="comment">    \par</span>
<a name="l01293"></a>01293 <span class="comment">    To set the board's current network settings as valid, send the message</span>
<a name="l01294"></a>01294 <span class="comment">    \verbatim /network/valid 1 \endverbatim</span>
<a name="l01295"></a>01295 <span class="comment">    To check if the current settings have been set as valid, send the message:</span>
<a name="l01296"></a>01296 <span class="comment">    \verbatim /network/valid \endverbatim</span>
<a name="l01297"></a>01297 <span class="comment">    with no argument value.</span>
<a name="l01298"></a>01298 <span class="comment"></span>
<a name="l01299"></a>01299 <span class="comment">    \par OSC UDP Port</span>
<a name="l01300"></a>01300 <span class="comment">    The \b osc_udp_port property corresponds to the port that the Make Controller listens on for</span>
<a name="l01301"></a>01301 <span class="comment">    incoming OSC messages via UDP.  This value is stored persistently, so it's available</span>
<a name="l01302"></a>01302 <span class="comment">    even after the board has rebooted.  This is 10000 by default.</span>
<a name="l01303"></a>01303 <span class="comment">    \par</span>
<a name="l01304"></a>01304 <span class="comment">    To tell the board to listen on port 10001, instead of the default 10000, send the message</span>
<a name="l01305"></a>01305 <span class="comment">    \code /network/osc_udp_port 10001 \endcode</span>
<a name="l01306"></a>01306 <span class="comment">    To read back the port that the board is currently listening on, send the message</span>
<a name="l01307"></a>01307 <span class="comment">    \verbatim /network/osc_udp_port \endverbatim</span>
<a name="l01308"></a>01308 <span class="comment">    with no argument value.</span>
<a name="l01309"></a>01309 <span class="comment"></span>
<a name="l01310"></a>01310 <span class="comment">    \par DHCP</span>
<a name="l01311"></a>01311 <span class="comment">    The \b dhcp property sets whether the board should try to dynamically retrieve a network address from </span>
<a name="l01312"></a>01312 <span class="comment">    a network router.  If no DHCP server is available, the board will use the network settings stored in memory</span>
<a name="l01313"></a>01313 <span class="comment">    for the \b address, \b gateway, and \b mask properties. If you're connecting the board directly to your computer, </span>
<a name="l01314"></a>01314 <span class="comment">    DHCP will not be available, so you should turn this off.</span>
<a name="l01315"></a>01315 <span class="comment">    \par</span>
<a name="l01316"></a>01316 <span class="comment">    To turn DHCP on, send the message</span>
<a name="l01317"></a>01317 <span class="comment">    \code /network/dhcp 1 \endcode</span>
<a name="l01318"></a>01318 <span class="comment">    and the board will immediately try to get an address.  To check what address the board got, send the message</span>
<a name="l01319"></a>01319 <span class="comment">    \code /network/address \endcode</span>
<a name="l01320"></a>01320 <span class="comment">    as you normally would.  To turn DHCP off, send the message</span>
<a name="l01321"></a>01321 <span class="comment">    \code /network/dhcp 0 \endcode</span>
<a name="l01322"></a>01322 <span class="comment">    To read whether DHCP is currently enabled on the board, send the message</span>
<a name="l01323"></a>01323 <span class="comment">    \code /network/dhcp \endcode</span>
<a name="l01324"></a>01324 <span class="comment">    with no argument value.</span>
<a name="l01325"></a>01325 <span class="comment">    </span>
<a name="l01326"></a>01326 <span class="comment">    \par Web Server</span>
<a name="l01327"></a>01327 <span class="comment">    The \b webserver property sets whether the demo web server on the Make Controller is running or not.</span>
<a name="l01328"></a>01328 <span class="comment">    The web server can provide current stats about the board through a web browser interface.  Because the web server</span>
<a name="l01329"></a>01329 <span class="comment">    consumes a significant chunk of the board's resources, it's best to turn it off when you're not using it.</span>
<a name="l01330"></a>01330 <span class="comment">    \par</span>
<a name="l01331"></a>01331 <span class="comment">    To turn the web server on, send the message</span>
<a name="l01332"></a>01332 <span class="comment">    \code /network/webserver 1 \endcode</span>
<a name="l01333"></a>01333 <span class="comment">    then enter the board's IP address into the address bar of your favorite web browser.  Send the message</span>
<a name="l01334"></a>01334 <span class="comment">    \code /network/webserver 0 \endcode</span>
<a name="l01335"></a>01335 <span class="comment">    to turn the webserver off.</span>
<a name="l01336"></a>01336 <span class="comment">   </span>
<a name="l01337"></a>01337 <span class="comment">    \par MAC</span>
<a name="l01338"></a>01338 <span class="comment">    The \b mac property corresponds to the Ethernet MAC address of the Controller Board.</span>
<a name="l01339"></a>01339 <span class="comment">    This value is read-only.  Each board on a network must have a unique MAC address.  The MAC address is generated</span>
<a name="l01340"></a>01340 <span class="comment">    using the board's serial number, so ensure that your board's serial numbers are unique.</span>
<a name="l01341"></a>01341 <span class="comment">    \par</span>
<a name="l01342"></a>01342 <span class="comment">    To read the MAC address of the Controller, send the message</span>
<a name="l01343"></a>01343 <span class="comment">    \verbatim /network/mac \endverbatim</span>
<a name="l01344"></a>01344 <span class="comment">    The board will respond by sending back an OSC message with the MAC address.</span>
<a name="l01345"></a>01345 <span class="comment">*/</span>
<a name="l01346"></a>01346 <span class="preprocessor">#ifdef OSC</span>
<a name="l01347"></a>01347 <span class="preprocessor"></span>
<a name="l01348"></a>01348 <span class="keywordtype">void</span> NetworkOsc_SetTcpAutoConnect( <span class="keywordtype">int</span> yesorno )
<a name="l01349"></a>01349 {
<a name="l01350"></a>01350   <span class="keywordtype">int</span> val = yesorno;
<a name="l01351"></a>01351   <span class="keywordflow">if</span>( val != 1 )
<a name="l01352"></a>01352     val = 0;
<a name="l01353"></a>01353   <span class="keywordflow">if</span>( yesorno != NetworkOsc_GetTcpAutoConnect( ) ) <span class="comment">// only write it if it has changed</span>
<a name="l01354"></a>01354     <a class="code" href="group___eeprom.html#g03d8b089bb0d04209e032ea233218d3a" title="Write data to the EEPROM.">Eeprom_Write</a>( EEPROM_TCP_AUTOCONNECT, (uchar*)&amp;yesorno, 4 );
<a name="l01355"></a>01355   <span class="keywordflow">if</span>( Network-&gt;TcpRequested == 0 &amp;&amp; yesorno ) <span class="comment">// if we're not already connected, connect now</span>
<a name="l01356"></a>01356   {
<a name="l01357"></a>01357     Network-&gt;TcpRequested = 1;
<a name="l01358"></a>01358     Osc_StartTcpTask( );
<a name="l01359"></a>01359   }
<a name="l01360"></a>01360 }
<a name="l01361"></a>01361 
<a name="l01362"></a>01362 <span class="keywordtype">int</span> NetworkOsc_GetTcpAutoConnect( )
<a name="l01363"></a>01363 {
<a name="l01364"></a>01364   <span class="keywordtype">int</span> state;
<a name="l01365"></a>01365   <a class="code" href="group___eeprom.html#g95bd921a774026d4cc96b20d6a20d9dd" title="Read data from the EEPROM.">Eeprom_Read</a>( EEPROM_TCP_AUTOCONNECT, (uchar*)&amp;state, 4 );
<a name="l01366"></a>01366   <span class="keywordflow">if</span>( state != 1 )
<a name="l01367"></a>01367     <span class="keywordflow">return</span> 0;
<a name="l01368"></a>01368   <span class="keywordflow">else</span>
<a name="l01369"></a>01369     <span class="keywordflow">return</span> state;
<a name="l01370"></a>01370 }
<a name="l01371"></a>01371 
<a name="l01372"></a>01372 <span class="keywordtype">int</span> NetworkOsc_GetTcpRequested( )
<a name="l01373"></a>01373 {
<a name="l01374"></a>01374   <span class="keywordflow">return</span> Network-&gt;TcpRequested;
<a name="l01375"></a>01375 }
<a name="l01376"></a>01376 
<a name="l01377"></a>01377 
<a name="l01378"></a>01378 <span class="preprocessor">#include "osc.h"</span>
<a name="l01379"></a>01379 <span class="keyword">static</span> <span class="keywordtype">char</span>* NetworkOsc_Name = <span class="stringliteral">"network"</span>;
<a name="l01380"></a>01380 <span class="keyword">static</span> <span class="keywordtype">char</span>* NetworkOsc_PropertyNames[] = { <span class="stringliteral">"active"</span>, <span class="stringliteral">"address"</span>, <span class="stringliteral">"mask"</span>, <span class="stringliteral">"gateway"</span>, <span class="stringliteral">"valid"</span>, <span class="stringliteral">"mac"</span>, 
<a name="l01381"></a>01381                                               <span class="stringliteral">"osc_udp_listen_port"</span>, <span class="stringliteral">"osc_tcpout_address"</span>, <span class="stringliteral">"osc_tcpout_port"</span>, 
<a name="l01382"></a>01382                                               <span class="stringliteral">"osc_tcpout_connect"</span>, <span class="stringliteral">"osc_tcpout_auto"</span>, <span class="stringliteral">"dhcp"</span>, 
<a name="l01383"></a>01383                                               <span class="stringliteral">"webserver"</span>, <span class="stringliteral">"find"</span>, <span class="stringliteral">"osc_udp_send_port"</span>, 0 }; <span class="comment">// must have a trailing 0</span>
<a name="l01384"></a>01384 
<a name="l01385"></a>01385 <span class="keywordtype">int</span> NetworkOsc_PropertySet( <span class="keywordtype">int</span> property, <span class="keywordtype">char</span>* typedata, <span class="keywordtype">int</span> channel );
<a name="l01386"></a>01386 <span class="keywordtype">int</span> NetworkOsc_PropertyGet( <span class="keywordtype">int</span> property, <span class="keywordtype">int</span> channel );
<a name="l01387"></a>01387 
<a name="l01388"></a>01388 <span class="keyword">const</span> <span class="keywordtype">char</span>* NetworkOsc_GetName( <span class="keywordtype">void</span> )
<a name="l01389"></a>01389 {
<a name="l01390"></a>01390   <span class="keywordflow">return</span> NetworkOsc_Name;
<a name="l01391"></a>01391 }
<a name="l01392"></a>01392 
<a name="l01393"></a>01393 <span class="keywordtype">int</span> NetworkOsc_ReceiveMessage( <span class="keywordtype">int</span> channel, <span class="keywordtype">char</span>* message, <span class="keywordtype">int</span> length )
<a name="l01394"></a>01394 {
<a name="l01395"></a>01395   <span class="keywordflow">if</span> ( Network_GetPending() )
<a name="l01396"></a>01396     <span class="keywordflow">return</span> <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a>;
<a name="l01397"></a>01397   
<a name="l01398"></a>01398   <span class="keywordtype">int</span> status = <a class="code" href="group___o_s_c_a_p_i.html#gbb24f5e4a4c94eef2c321020941c45b3" title="Receive data for a subsystem that receives a variety of different data types.">Osc_GeneralReceiverHelper</a>( channel, message, length, 
<a name="l01399"></a>01399                                 NetworkOsc_Name,
<a name="l01400"></a>01400                                 NetworkOsc_PropertySet, NetworkOsc_PropertyGet, 
<a name="l01401"></a>01401                                 NetworkOsc_PropertyNames );
<a name="l01402"></a>01402 
<a name="l01403"></a>01403   <span class="keywordflow">if</span> ( status != <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> )
<a name="l01404"></a>01404     <span class="keywordflow">return</span> Osc_SendError( channel, NetworkOsc_Name, status );
<a name="l01405"></a>01405 
<a name="l01406"></a>01406   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l01407"></a>01407 }
<a name="l01408"></a>01408 
<a name="l01409"></a>01409 <span class="keywordtype">int</span> NetworkOsc_Poll( )
<a name="l01410"></a>01410 {
<a name="l01411"></a>01411   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l01412"></a>01412 }
<a name="l01413"></a>01413 
<a name="l01414"></a>01414 <span class="comment">// Sets the property with the value</span>
<a name="l01415"></a>01415 <span class="keywordtype">int</span> NetworkOsc_PropertySet( <span class="keywordtype">int</span> property, <span class="keywordtype">char</span>* typedata, <span class="keywordtype">int</span> channel )
<a name="l01416"></a>01416 {
<a name="l01417"></a>01417   <span class="keywordtype">int</span> a0;
<a name="l01418"></a>01418   <span class="keywordtype">int</span> a1; 
<a name="l01419"></a>01419   <span class="keywordtype">int</span> a2;
<a name="l01420"></a>01420   <span class="keywordtype">int</span> a3;
<a name="l01421"></a>01421 
<a name="l01422"></a>01422   <span class="keywordflow">switch</span> ( property )
<a name="l01423"></a>01423   {
<a name="l01424"></a>01424     <span class="keywordflow">case</span> 0: <span class="comment">// active</span>
<a name="l01425"></a>01425     {
<a name="l01426"></a>01426       <span class="keywordtype">int</span> value;
<a name="l01427"></a>01427       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01428"></a>01428       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01429"></a>01429         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01430"></a>01430 
<a name="l01431"></a>01431       <a class="code" href="group___network.html#g0989090dd4929827de8708269f808e5b" title="Sets whether the Network subsystem is active.">Network_SetActive</a>( value );
<a name="l01432"></a>01432       <span class="keywordflow">break</span>;
<a name="l01433"></a>01433     }
<a name="l01434"></a>01434     <span class="keywordflow">case</span> 1: <span class="comment">// address</span>
<a name="l01435"></a>01435     {
<a name="l01436"></a>01436       <span class="keywordtype">char</span>* address;
<a name="l01437"></a>01437       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"s"</span>, &amp;address );
<a name="l01438"></a>01438       <span class="keywordflow">if</span> ( count != 1 ) 
<a name="l01439"></a>01439         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need a string"</span> );
<a name="l01440"></a>01440       <span class="keywordtype">int</span> status = Network_AddressConvert( address, &amp;a0, &amp;a1, &amp;a2, &amp;a3 );
<a name="l01441"></a>01441       <span class="keywordflow">if</span> ( status != <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> )
<a name="l01442"></a>01442         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect address - need 'a.b.c.d'"</span> );
<a name="l01443"></a>01443 
<a name="l01444"></a>01444       <a class="code" href="group___network.html#g8efe3e0915b89c461da231653b7bd3b7" title="Set the IP address of the Make Controller.">Network_SetAddress</a>( a0, a1, a2, a3 );
<a name="l01445"></a>01445 
<a name="l01446"></a>01446       <span class="keywordflow">break</span>;
<a name="l01447"></a>01447     }
<a name="l01448"></a>01448     <span class="keywordflow">case</span> 2: <span class="comment">// mask</span>
<a name="l01449"></a>01449     {
<a name="l01450"></a>01450       <span class="keywordtype">char</span>* address;
<a name="l01451"></a>01451       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"s"</span>, &amp;address );
<a name="l01452"></a>01452       <span class="keywordflow">if</span> ( count != 1 ) 
<a name="l01453"></a>01453         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need a string"</span> );
<a name="l01454"></a>01454       <span class="keywordtype">int</span> status = Network_AddressConvert( address, &amp;a0, &amp;a1, &amp;a2, &amp;a3 );
<a name="l01455"></a>01455       <span class="keywordflow">if</span> ( status != <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> )
<a name="l01456"></a>01456         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect mask - need 'a.b.c.d'"</span> );
<a name="l01457"></a>01457 
<a name="l01458"></a>01458       <a class="code" href="group___network.html#g8f1c006937cf5985de44cf8cd0751642" title="Set the network mask of the Make Controller on your local network.">Network_SetMask</a>( a0, a1, a2, a3 );
<a name="l01459"></a>01459 
<a name="l01460"></a>01460       <span class="keywordflow">break</span>;
<a name="l01461"></a>01461     }
<a name="l01462"></a>01462     <span class="keywordflow">case</span> 3: <span class="comment">// gateway </span>
<a name="l01463"></a>01463     {
<a name="l01464"></a>01464       <span class="keywordtype">char</span>* address;
<a name="l01465"></a>01465       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"s"</span>, &amp;address );
<a name="l01466"></a>01466       <span class="keywordflow">if</span> ( count != 1 ) 
<a name="l01467"></a>01467         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need a string"</span> );
<a name="l01468"></a>01468       <span class="keywordtype">int</span> status = Network_AddressConvert( address, &amp;a0, &amp;a1, &amp;a2, &amp;a3 );
<a name="l01469"></a>01469       <span class="keywordflow">if</span> ( status != <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> )
<a name="l01470"></a>01470         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect gateway - need 'a.b.c.d'"</span> );
<a name="l01471"></a>01471 
<a name="l01472"></a>01472       <a class="code" href="group___network.html#g1a5be7ffdac1a43d83f6c84369d0bb55" title="Set the gateway address for the local network the Make Controller is on.">Network_SetGateway</a>( a0, a1, a2, a3 );
<a name="l01473"></a>01473 
<a name="l01474"></a>01474       <span class="keywordflow">break</span>;
<a name="l01475"></a>01475     }
<a name="l01476"></a>01476     <span class="keywordflow">case</span> 4: <span class="comment">// valid</span>
<a name="l01477"></a>01477     {
<a name="l01478"></a>01478       <span class="keywordtype">int</span> value;
<a name="l01479"></a>01479       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01480"></a>01480       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01481"></a>01481         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01482"></a>01482 
<a name="l01483"></a>01483       <a class="code" href="network_8c.html#ee640cb0ab458e093969dcbdfed7e246" title="Create a checksum for the current address settings and store it in EEPROM.">Network_SetValid</a>( value ); 
<a name="l01484"></a>01484       <span class="keywordflow">break</span>;
<a name="l01485"></a>01485     }
<a name="l01486"></a>01486     <span class="keywordflow">case</span> 5: <span class="comment">// mac</span>
<a name="l01487"></a>01487     {
<a name="l01488"></a>01488       <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"MAC is read only."</span> );
<a name="l01489"></a>01489     }
<a name="l01490"></a>01490     <span class="keywordflow">case</span> 6: <span class="comment">// osc_udp_listen_port</span>
<a name="l01491"></a>01491     {
<a name="l01492"></a>01492       <span class="keywordtype">int</span> value;
<a name="l01493"></a>01493       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01494"></a>01494       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01495"></a>01495         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01496"></a>01496 
<a name="l01497"></a>01497       NetworkOsc_SetUdpListenPort( value );
<a name="l01498"></a>01498       <span class="keywordflow">break</span>;
<a name="l01499"></a>01499     }
<a name="l01500"></a>01500     <span class="keywordflow">case</span> 7: <span class="comment">// osc_tcpout_address</span>
<a name="l01501"></a>01501     {
<a name="l01502"></a>01502       <span class="keywordtype">char</span>* address;
<a name="l01503"></a>01503       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"s"</span>, &amp;address );
<a name="l01504"></a>01504       <span class="keywordflow">if</span> ( count != 1 ) 
<a name="l01505"></a>01505         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need a string"</span> );
<a name="l01506"></a>01506       <span class="comment">// don't strictly need to do this, but it's god to make sure it's a proper address</span>
<a name="l01507"></a>01507       <span class="keywordtype">int</span> status = Network_AddressConvert( address, &amp;a0, &amp;a1, &amp;a2, &amp;a3 );
<a name="l01508"></a>01508       <span class="keywordflow">if</span> ( status != <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a> )
<a name="l01509"></a>01509         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect TCP address - need 'xxx.xxx.xxx.xxx'"</span> );
<a name="l01510"></a>01510       
<a name="l01511"></a>01511       NetworkOsc_SetTcpOutAddress( a0, a1, a2, a3 );
<a name="l01512"></a>01512       <span class="keywordflow">break</span>;
<a name="l01513"></a>01513     }
<a name="l01514"></a>01514     <span class="keywordflow">case</span> 8: <span class="comment">// osc_tcpout_port</span>
<a name="l01515"></a>01515     {
<a name="l01516"></a>01516       <span class="keywordtype">int</span> value;
<a name="l01517"></a>01517       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01518"></a>01518       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01519"></a>01519         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01520"></a>01520 
<a name="l01521"></a>01521       NetworkOsc_SetTcpOutPort( value );
<a name="l01522"></a>01522       <span class="keywordflow">break</span>;
<a name="l01523"></a>01523     }
<a name="l01524"></a>01524     <span class="keywordflow">case</span> 9: <span class="comment">// osc_tcpout_connect</span>
<a name="l01525"></a>01525     {
<a name="l01526"></a>01526       <span class="keywordtype">int</span> value;
<a name="l01527"></a>01527       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01528"></a>01528       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01529"></a>01529         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01530"></a>01530 
<a name="l01531"></a>01531       <span class="keywordflow">if</span>( value &amp;&amp; Network-&gt;TcpRequested == 0 )
<a name="l01532"></a>01532       {
<a name="l01533"></a>01533         Network-&gt;TcpRequested = 1;
<a name="l01534"></a>01534         Osc_StartTcpTask( );
<a name="l01535"></a>01535       }
<a name="l01536"></a>01536       <span class="keywordflow">if</span>( !value &amp;&amp; Network-&gt;TcpRequested == 1 )  
<a name="l01537"></a>01537         Network-&gt;TcpRequested = 0;
<a name="l01538"></a>01538 
<a name="l01539"></a>01539       <span class="keywordflow">break</span>;
<a name="l01540"></a>01540     }
<a name="l01541"></a>01541     <span class="keywordflow">case</span> 10: <span class="comment">// osc_tcpout_auto</span>
<a name="l01542"></a>01542     {
<a name="l01543"></a>01543       <span class="keywordtype">int</span> value;
<a name="l01544"></a>01544       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01545"></a>01545       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01546"></a>01546         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01547"></a>01547 
<a name="l01548"></a>01548       NetworkOsc_SetTcpAutoConnect( value );
<a name="l01549"></a>01549       <span class="keywordflow">break</span>;
<a name="l01550"></a>01550     }
<a name="l01551"></a>01551     <span class="keywordflow">case</span> 11: <span class="comment">// dhcp</span>
<a name="l01552"></a>01552     {
<a name="l01553"></a>01553       <span class="keywordtype">int</span> value;
<a name="l01554"></a>01554       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01555"></a>01555       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01556"></a>01556         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01557"></a>01557       
<a name="l01558"></a>01558       <a class="code" href="group___network.html#gc61ff10637ea2e5a44c4af330693e9e0" title="Set whether DHCP is enabled.">Network_SetDhcpEnabled</a>( value );
<a name="l01559"></a>01559       <span class="keywordflow">break</span>;
<a name="l01560"></a>01560     }
<a name="l01561"></a>01561     <span class="keywordflow">case</span> 12: <span class="comment">// webserver</span>
<a name="l01562"></a>01562     {
<a name="l01563"></a>01563       <span class="keywordtype">int</span> value;
<a name="l01564"></a>01564       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01565"></a>01565       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01566"></a>01566         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01567"></a>01567       
<a name="l01568"></a>01568       <a class="code" href="group___network.html#g8e37b3166ad4cafc5261e3de373e9261" title="Set whether the demo webserver is enabled.">Network_SetWebServerEnabled</a>( value );
<a name="l01569"></a>01569       <span class="keywordflow">break</span>;
<a name="l01570"></a>01570     }
<a name="l01571"></a>01571     <span class="keywordflow">case</span> 14: <span class="comment">// osc_udp_send_port</span>
<a name="l01572"></a>01572     {
<a name="l01573"></a>01573       <span class="keywordtype">int</span> value;
<a name="l01574"></a>01574       <span class="keywordtype">int</span> count = Osc_ExtractData( typedata, <span class="stringliteral">"i"</span>, &amp;value );
<a name="l01575"></a>01575       <span class="keywordflow">if</span> ( count != 1 )
<a name="l01576"></a>01576         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"Incorrect data - need an int"</span> );
<a name="l01577"></a>01577 
<a name="l01578"></a>01578       NetworkOsc_SetUdpSendPort( value );
<a name="l01579"></a>01579       <span class="keywordflow">break</span>;
<a name="l01580"></a>01580     }
<a name="l01581"></a>01581   }
<a name="l01582"></a>01582   <span class="keywordflow">return</span> <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l01583"></a>01583 }
<a name="l01584"></a>01584 
<a name="l01585"></a>01585 <span class="comment">// Get the property</span>
<a name="l01586"></a>01586 <span class="keywordtype">int</span> NetworkOsc_PropertyGet( <span class="keywordtype">int</span> property, <span class="keywordtype">int</span> channel )
<a name="l01587"></a>01587 {
<a name="l01588"></a>01588   <span class="keywordtype">int</span> value;
<a name="l01589"></a>01589   <span class="keywordtype">int</span> result = <a class="code" href="group___error.html#gaa42bc036fbba18487ae9a15cd1f2f94" title="All&amp;#39;s well here.">CONTROLLER_OK</a>;
<a name="l01590"></a>01590   <span class="keywordtype">int</span> a0;
<a name="l01591"></a>01591   <span class="keywordtype">int</span> a1; 
<a name="l01592"></a>01592   <span class="keywordtype">int</span> a2;
<a name="l01593"></a>01593   <span class="keywordtype">int</span> a3;
<a name="l01594"></a>01594 
<a name="l01595"></a>01595   <span class="keywordflow">switch</span> ( property )
<a name="l01596"></a>01596   {
<a name="l01597"></a>01597     <span class="keywordflow">case</span> 0:
<a name="l01598"></a>01598       value = <a class="code" href="group___network.html#gb1f4725187ab9011d327ed8e05e4746c" title="Returns the active state of the Network subsystem.">Network_GetActive</a>( );
<a name="l01599"></a>01599       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01600"></a>01600       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );      
<a name="l01601"></a>01601       <span class="keywordflow">break</span>;
<a name="l01602"></a>01602     <span class="keywordflow">case</span> 1:
<a name="l01603"></a>01603       <span class="keywordflow">if</span> ( <a class="code" href="group___network.html#gf5c24462c4ca5bfcf8a9ffdb80c290d8" title="Read the board&amp;#39;s current IP address.">Network_GetAddress</a>( &amp;a0, &amp;a1, &amp;a2, &amp;a3 ) == <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a> )
<a name="l01604"></a>01604         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"No network address available - try plugging in an Ethernet cable."</span> );
<a name="l01605"></a>01605       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01606"></a>01606       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 );
<a name="l01607"></a>01607       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",s"</span>, Network-&gt;scratch2 );      
<a name="l01608"></a>01608       <span class="keywordflow">break</span>;
<a name="l01609"></a>01609     <span class="keywordflow">case</span> 2:
<a name="l01610"></a>01610       <span class="keywordflow">if</span> ( <a class="code" href="group___network.html#ga0837a01a5bd814cae2a080f8b2bf86b" title="Read the board&amp;#39;s current network mask.">Network_GetMask</a>( &amp;a0, &amp;a1, &amp;a2, &amp;a3 ) == <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a> )
<a name="l01611"></a>01611         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"No mask available - try plugging in an Ethernet cable."</span> );
<a name="l01612"></a>01612       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01613"></a>01613       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 );
<a name="l01614"></a>01614       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",s"</span>, Network-&gt;scratch2 );      
<a name="l01615"></a>01615       <span class="keywordflow">break</span>;
<a name="l01616"></a>01616     <span class="keywordflow">case</span> 3:
<a name="l01617"></a>01617       <span class="keywordflow">if</span> ( <a class="code" href="group___network.html#ge91ce5f124fcfbabc529d75fc222d49e" title="Read the board&amp;#39;s current gateway address.">Network_GetGateway</a>( &amp;a0, &amp;a1, &amp;a2, &amp;a3 ) == <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a> )
<a name="l01618"></a>01618         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"No gateway available - try plugging in an Ethernet cable."</span> );
<a name="l01619"></a>01619       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01620"></a>01620       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 );
<a name="l01621"></a>01621       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",s"</span>, Network-&gt;scratch2 );      
<a name="l01622"></a>01622       <span class="keywordflow">break</span>;
<a name="l01623"></a>01623     <span class="keywordflow">case</span> 4:
<a name="l01624"></a>01624       value = <a class="code" href="network_8c.html#66046b3c42a64a18478cdcc685e22528" title="Read the checksum for address settings in EEPROM, and determine if it matches the...">Network_GetValid</a>( );
<a name="l01625"></a>01625       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01626"></a>01626       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );      
<a name="l01627"></a>01627       <span class="keywordflow">break</span>;
<a name="l01628"></a>01628     <span class="keywordflow">case</span> 5:
<a name="l01629"></a>01629       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01630"></a>01630       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%02X:%02X:%02X:%02X:%02X:%02X"</span>, 
<a name="l01631"></a>01631                 emacETHADDR0, emacETHADDR1, emacETHADDR2, emacETHADDR3, emacETHADDR4, emacETHADDR5 );
<a name="l01632"></a>01632       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",s"</span>, Network-&gt;scratch2 );      
<a name="l01633"></a>01633       <span class="keywordflow">break</span>;
<a name="l01634"></a>01634     <span class="keywordflow">case</span> 6: <span class="comment">// osc_udp_listen_port</span>
<a name="l01635"></a>01635       value = NetworkOsc_GetUdpListenPort( );
<a name="l01636"></a>01636       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01637"></a>01637       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );      
<a name="l01638"></a>01638       <span class="keywordflow">break</span>;
<a name="l01639"></a>01639     <span class="keywordflow">case</span> 7: <span class="comment">// osc_tcpout_address</span>
<a name="l01640"></a>01640       value = NetworkOsc_GetTcpOutAddress( );
<a name="l01641"></a>01641       a0 = IP_ADDRESS_A( value );
<a name="l01642"></a>01642       a1 = IP_ADDRESS_B( value );
<a name="l01643"></a>01643       a2 = IP_ADDRESS_C( value );
<a name="l01644"></a>01644       a3 = IP_ADDRESS_D( value );
<a name="l01645"></a>01645       Network_AddressConvert( Network-&gt;scratch1, &amp;a0, &amp;a1, &amp;a2, &amp;a3 );
<a name="l01646"></a>01646       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01647"></a>01647       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 );
<a name="l01648"></a>01648       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",s"</span>, Network-&gt;scratch2 );    
<a name="l01649"></a>01649       <span class="keywordflow">break</span>;
<a name="l01650"></a>01650     <span class="keywordflow">case</span> 8: <span class="comment">// osc_tcpout_port</span>
<a name="l01651"></a>01651       value = NetworkOsc_GetTcpOutPort( );
<a name="l01652"></a>01652       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01653"></a>01653       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );
<a name="l01654"></a>01654       <span class="keywordflow">break</span>;
<a name="l01655"></a>01655     <span class="keywordflow">case</span> 9: <span class="comment">// osc_tcpout_connect</span>
<a name="l01656"></a>01656       value = NetworkOsc_GetTcpRequested( );
<a name="l01657"></a>01657       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01658"></a>01658       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );
<a name="l01659"></a>01659       <span class="keywordflow">break</span>;
<a name="l01660"></a>01660     <span class="keywordflow">case</span> 10: <span class="comment">// osc_tcpout_auto</span>
<a name="l01661"></a>01661       value = NetworkOsc_GetTcpAutoConnect( );
<a name="l01662"></a>01662       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01663"></a>01663       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );
<a name="l01664"></a>01664       <span class="keywordflow">break</span>;
<a name="l01665"></a>01665     <span class="keywordflow">case</span> 11: <span class="comment">// dhcp</span>
<a name="l01666"></a>01666       value = <a class="code" href="group___network.html#ge24b6f9eecab6b6339bfc19524ff3f60" title="Read whether DHCP is currently enabled.">Network_GetDhcpEnabled</a>( );
<a name="l01667"></a>01667       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01668"></a>01668       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );      
<a name="l01669"></a>01669       <span class="keywordflow">break</span>;
<a name="l01670"></a>01670     <span class="keywordflow">case</span> 12: <span class="comment">// webserver</span>
<a name="l01671"></a>01671       value = <a class="code" href="group___network.html#g371af21b1030735315a0c101aee27ace" title="Read whether the demo webserver is enabled.">Network_GetWebServerEnabled</a>( );
<a name="l01672"></a>01672       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01673"></a>01673       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );      
<a name="l01674"></a>01674       <span class="keywordflow">break</span>;
<a name="l01675"></a>01675     <span class="keywordflow">case</span> 13: <span class="comment">// find</span>
<a name="l01676"></a>01676     {
<a name="l01677"></a>01677       <span class="keywordflow">if</span> ( <a class="code" href="group___network.html#gf5c24462c4ca5bfcf8a9ffdb80c290d8" title="Read the board&amp;#39;s current IP address.">Network_GetAddress</a>( &amp;a0, &amp;a1, &amp;a2, &amp;a3 ) == <a class="code" href="group___error.html#g5247299a6a6caa7c59f0e222476f63a0" title="The network is not up.">CONTROLLER_ERROR_NO_NETWORK</a> )
<a name="l01678"></a>01678         <span class="keywordflow">return</span> <a class="code" href="group___o_s_c_a_p_i.html#g852200f3d0612d90d73e9f233392ec2d" title="Send an error back via OSC from your subsystem.">Osc_SubsystemError</a>( channel, NetworkOsc_Name, <span class="stringliteral">"No network address available - try plugging in an Ethernet cable."</span> );
<a name="l01679"></a>01679       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01680"></a>01680       snprintf( Network-&gt;scratch2, OSC_SCRATCH_SIZE, <span class="stringliteral">"%d.%d.%d.%d"</span>, a0, a1, a2, a3 );
<a name="l01681"></a>01681       <span class="keywordtype">int</span> listen = NetworkOsc_GetUdpListenPort( );
<a name="l01682"></a>01682       <span class="keywordtype">int</span> send = NetworkOsc_GetUdpSendPort( );
<a name="l01683"></a>01683       <span class="keywordtype">char</span>* sysName = <a class="code" href="group___system.html#g1bcad57269385df99b23c8e9de3f81fc" title="Read the board&amp;#39;s name.">System_GetName</a>( );
<a name="l01684"></a>01684       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",siis"</span>, Network-&gt;scratch2, listen, send, sysName );      
<a name="l01685"></a>01685       <span class="keywordflow">break</span>;
<a name="l01686"></a>01686     }
<a name="l01687"></a>01687     <span class="keywordflow">case</span> 14: <span class="comment">// osc_udp_send_port</span>
<a name="l01688"></a>01688       value = NetworkOsc_GetUdpSendPort( );
<a name="l01689"></a>01689       snprintf( Network-&gt;scratch1, OSC_SCRATCH_SIZE, <span class="stringliteral">"/%s/%s"</span>, NetworkOsc_Name, NetworkOsc_PropertyNames[ property ] ); 
<a name="l01690"></a>01690       Osc_CreateMessage( channel, Network-&gt;scratch1, <span class="stringliteral">",i"</span>, value );         
<a name="l01691"></a>01691       <span class="keywordflow">break</span>;
<a name="l01692"></a>01692   }
<a name="l01693"></a>01693   
<a name="l01694"></a>01694   <span class="keywordflow">return</span> result;
<a name="l01695"></a>01695 }
<a name="l01696"></a>01696 
<a name="l01697"></a>01697 <span class="preprocessor">#endif // OSC</span>
<a name="l01698"></a>01698 <span class="preprocessor"></span>
<a name="l01699"></a>01699 <span class="preprocessor">#endif // MAKE_CTRL_NETWORK</span>
<a name="l01700"></a>01700 <span class="preprocessor"></span>
<a name="l01701"></a>01701 
</pre></div><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Make Controller Kit</title>
<style type="text/css">
<!--
.footer {
	font-family: Verdana, Arial, Helvetica, sans-serif;
	font-size: 9pt;
	color: #999999;
}
-->
</style>
</head>

<body>
<hr size="1">
<div>
  <p class="footer">The Make Controller Kit is an open source project maintained by <a href="http://www.makingthings.com">MakingThings</a>.<br />
    MakingThings code is released under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html" target="_blank">Apache 2.0 license</a>.<br />
    Bug tracker, development wiki and status can be found at <a href="http://dev.makingthings.com">http://dev.makingthings.com</a>.<br />
		This document was last updated on 5 Dec 2007.
</p>
</div>
<!-- Google Analytics Code -->
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-769030-1";
urchinTracker();
</script>
</body>
</html>
